pyenv-win 配置指南?

在 Python 開發過程中，經常會遇到需要使用不同版本 Python 的情況。比如，舊項目依賴某個特定的 Python 版本，而新項目則要求使用更新的版本。這時，版本管理工具就顯得尤為重要。pyenv-win就是一款專門為 Windows 系統設計的 Python 版本管理工具，它能夠讓開發者在同一臺機器上輕松安裝、切換和管理多個 Python 版本。本文將詳細介紹pyenv-win的配置方法以及可能遇到的問題和解決辦法。?

安裝前的準備工作?

安裝 Git：pyenv-win依賴于 Git 進行安裝和更新。如果你的系統尚未安裝 Git，可以前往Git 官網下載安裝包進行安裝。安裝過程中，按照默認設置即可，確保勾選將 Git 添加到系統路徑的選項，以便在命令行中能夠直接使用 Git 命令。?

安裝 Python（可選）：雖然pyenv-win可以管理多個 Python 版本，但首次安裝pyenv-win時，系統中至少需要有一個 Python 版本。你可以從Python 官網下載并安裝一個 Python 版本。安裝時，務必勾選 “Add Python to PATH” 選項，這樣系統才能正確識別 Python 命令。?

安裝 pyenv-win?

方法一：使用 PowerShell 安裝?

以管理員身份打開 PowerShell。在 Windows 搜索欄中輸入 “PowerShell”，右鍵點擊 “Windows PowerShell”，選擇 “以管理員身份運行”。?

在 PowerShell 中運行以下命令，該命令會從 GitHub 下載并運行pyenv-win的安裝腳本：?

TypeScript取消自動換行復制

Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1" ; &"./install-pyenv-win.ps1"?

可能遇到的問題及解決辦法：?

問題：運行上述命令時遇到 “未經授權的訪問錯誤”。?

解決辦法：再次以管理員身份打開 PowerShell，運行命令Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine，該命令用于設置腳本執行策略，允許運行從互聯網下載且經過數字簽名的腳本。?

問題：遇到 “未數字簽名” 錯誤。?

解決辦法：執行命令Unblock-File (Join-Path $env:pyenv 'bin/pyenv.ps1')來解除對pyenv腳本的阻止。?

方法二：手動安裝?

訪問pyenv-win的GitHub 倉庫。?

點擊頁面上的 “Code” 按鈕，選擇 “Download ZIP” 下載pyenv-win的壓縮包。?

創建一個.pyenv文件夾在你的用戶目錄下。可以通過在 PowerShell 或 Git Bash 中運行命令mkdir $HOME/.pyenv來創建。?

解壓下載的pyenv-win.zip文件到剛剛創建的.pyenv目錄中。解壓后，你應該在$HOME/.pyenv/pyenv-win/bin路徑下看到bin目錄。?

方法三：使用 Windows 包管理器安裝?

使用 Chocolatey 安裝：如果你的系統安裝了 Chocolatey 包管理器，可以在命令提示符或 PowerShell 中運行命令choco install pyenv-win來安裝pyenv-win。?

使用 Scoop 安裝：如果使用 Scoop 包管理器，首先在 PowerShell 中運行命令scoop bucket add main添加主存儲庫，然后運行scoop install main/pyenv來安裝pyenv-win。需要注意的是，在撰寫本文時，pyenv-win尚未在winget存儲庫中。?

配置環境變量?

安裝完成后，需要配置系統環境變量，確保系統能夠正確識別pyenv-win。?

添加 PYENV 變量：按下 Windows 鍵，搜索 “編輯賬戶的環境變量” 并打開。在 “用戶變量” 部分，點擊 “新建” 按鈕。?

變量名：PYENV?

變量值：C:\Users\你的用戶名\.pyenv\pyenv-win（請將 “你的用戶名” 替換為你實際的 Windows 用戶名）?

添加 PYENV_HOME 變量：同樣在 “用戶變量” 中，點擊 “新建”。?

變量名：PYENV_HOME?

變量值：C:\Users\你的用戶名\.pyenv\pyenv-win?

添加 PYENV_ROOT 變量：繼續在 “用戶變量” 中新建變量。?

變量名：PYENV_ROOT?

變量值：C:\Users\你的用戶名\.pyenv\pyenv-win?

更新 Path 變量：在 “系統變量” 中找到 “Path” 變量，雙擊打開編輯窗口。點擊 “新建”，添加以下兩個路徑：?

%USERPROFILE%\.pyenv\pyenv-win\bin?

%USERPROFILE%\.pyenv\pyenv-win\shims?

完成上述操作后，點擊 “確定” 保存所有環境變量的更改。?

可能遇到的環境變量配置問題及解決辦法?

問題：重啟 PowerShell 后，執行pyenv --version提示 "pyenv 不是內部或外部命令"。?

解決辦法：檢查環境變量配置是否正確，確保%USERPROFILE%\.pyenv\pyenv-win\bin和%USERPROFILE%\.pyenv\pyenv-win\shims已添加到系統 Path 變量中；重新打開 PowerShell 窗口或重啟電腦使環境變量生效。?

問題：設置了全局 Python 版本，但執行python --version仍顯示舊版本。?

解決辦法：檢查系統環境變量中是否存在其他 Python 路徑，優先于pyenv的路徑，如有則調整順序；執行pyenv rehash更新 shim 文件。?

驗證安裝?

重新打開一個新的 PowerShell 窗口（確保不是之前以管理員身份打開的那個），運行命令pyenv --version。如果安裝和配置成功，該命令會顯示pyenv-win的版本號，例如 “pyenv 2.64.11”。?

使用 pyenv-win 管理 Python 版本?

查看可安裝版本?

運行命令pyenv install --list，該命令會列出所有pyenv-win支持安裝的 Python 版本（僅限 Windows 預編譯版）。列表可能會很長，你可以通過管道符|結合findstr命令進行篩選，例如pyenv install --list | findstr 3.8，這將只列出與 Python 3.8 相關的版本。?

安裝指定版本?

使用命令pyenv install <版本號>來安裝指定版本的 Python。例如，要安裝 Python 3.9.5，運行pyenv install 3.9.5。安裝過程可能需要一些時間，期間會從 Python 官方網站下載安裝包并進行安裝。如果下載速度很慢，可以嘗試使用鏡像源加速下載，命令格式為pyenv install <版本號> --mirror <鏡像源地址>，例如pyenv install 3.9.5 --mirror https://npm.taobao.org/mirrors/python/。另外，也可以手動從 Python 官網下載對應版本的.zip文件，將文件放入~\.pyenv\pyenv-win\install_cache目錄下，然后再執行pyenv install <版本號>命令進行安裝。?

查看已安裝版本?

運行pyenv versions命令，該命令會列出所有已安裝的 Python 版本，其中帶有*號的版本表示當前激活的版本。?

設置全局默認版本?

使用pyenv global <版本號>命令可以設置全局默認的 Python 版本。例如，pyenv global 3.9.5將把系統的全局默認 Python 版本設置為 3.9.5，在沒有其他局部或臨時版本設置的情況下，系統將使用該版本的 Python。?

設置局部版本（當前目錄）?

在項目目錄中，運行pyenv local <版本號>命令可以設置當前目錄及其子目錄使用的 Python 版本。執行該命令后，會在當前目錄下生成一個.python-version文件，文件內容為設置的版本號。當在該目錄及其子目錄中運行 Python 相關命令時，系統會自動使用該版本的 Python。?