pyenv 是 Python 版本管理工具，支持多版本共存与隔离。介绍其核心功能，包括全局、局部及临时版本切换，以及依赖包隔离机制。内容涵盖 Windows 下的安装步骤、常用命令列表及具体使用示例，帮助用户实现不同项目间 Python 环境的独立管理与快速切换。
pyenv（Windows 下为 pyenv-win）是 Python 版本管理工具，核心解决多 Python 版本共存、版本冲突及环境不一致等问题，让用户在一台电脑上无缝切换不同 Python 版本，无需手动修改环境变量或卸载重装。
手动管理多个 Python 版本时，需反复修改环境变量并记住不同版本的安装路径，极易混乱。pyenv 能实现：
~/.pyenv 目录（Windows：%USERPROFILE%\.pyenv），互不干扰；| 切换维度 | 作用范围 | 适用场景 |
|---|
| 全局版本 | 整个系统（所有目录） | 设置系统默认 Python 版本 |
| 局部版本 | 当前目录 + 子目录 | 项目专属版本 |
| 临时版本 | 仅当前终端会话 | 临时测试某个版本 |
不同 Python 版本的 pip 包是完全隔离的，不会出现跨版本污染：
pyenv install 3.10.11，自动下载、安装、配置；pyenv uninstall 3.10.11，彻底删除该版本及对应依赖，无残留；Windows 系统
powershell -ExecutionPolicy Bypass -Command "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"
如果已下载 install-pyenv-win.ps1 到 Downloads 目录，直接执行：
cd %USERPROFILE%\Downloads
powershell -ExecutionPolicy Bypass -File .\install-pyenv-win.ps1
脚本会自动将 pyenv-win 安装到 %USERPROFILE%\.pyenv\pyenv-win，并配置环境变量（PYENV_ROOT、PATH 添加 bin 和 shims 路径）。
若网络受限无法下载脚本，可直接保存以下内容为 install-pyenv-win.ps1：
<# .SYNOPSIS Installs pyenv-win .DESCRIPTION Installs pyenv-win to $HOME\.pyenv If pyenv-win is already installed, try to update to the latest version. .PARAMETER Uninstall Uninstall pyenv-win. Note that this uninstalls any Python versions that were installed with pyenv-win. .INPUTS None. .OUTPUTS None. .EXAMPLE PS> install-pyenv-win.ps1 .LINK Online version: https://pyenv-win.github.io/pyenv-win/ #>
param (
[Switch] $Uninstall = $False
)
$PyEnvDir = "${env:USERPROFILE}\.pyenv"
$PyEnvWinDir = "${PyEnvDir}\pyenv-win"
$BinPath = "${PyEnvWinDir}\bin"
$ShimsPath = "${PyEnvWinDir}\shims"
Function Remove-PyEnvVars() {
$PathParts = [System.Environment]::GetEnvironmentVariable('PATH', "User") -Split ";"
$NewPathParts = $PathParts.Where{ $_ -ne $BinPath }.Where{ $_ -ne $ShimsPath }
$NewPath = $NewPathParts -Join ";"
[System.Environment]::SetEnvironmentVariable('PATH', $NewPath, "User")
[System.Environment]::SetEnvironmentVariable('PYENV', $null, "User")
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT', $null, "User")
[System.Environment]::SetEnvironmentVariable('PYENV_HOME', $null, "User")
}
Function Remove-PyEnv() {
Write-Host "Removing $PyEnvDir..."
If (Test-Path $PyEnvDir) { Remove-Item -Path $PyEnvDir -Recurse }
Write-Host "Removing environment variables..."
Remove-PyEnvVars
}
Function Get-CurrentVersion() {
$VersionFilePath = "$PyEnvDir\.version"
If (Test-Path $VersionFilePath) { $CurrentVersion = Get-Content $VersionFilePath } Else { $CurrentVersion = "" }
Return $CurrentVersion
}
Function Get-LatestVersion() {
$LatestVersionFilePath = "$PyEnvDir\latest.version"
(New-Object System.Net.WebClient).DownloadFile("https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/.version", $LatestVersionFilePath)
$LatestVersion = Get-Content $LatestVersionFilePath
Remove-Item -Path $LatestVersionFilePath
Return $LatestVersion
}
Function Main() {
If ($Uninstall) {
Remove-PyEnv
If ($? -eq $True) { Write-Host "pyenv-win successfully uninstalled." } Else { Write-Host "Uninstallation failed." }
exit
}
$BackupDir = "${env:Temp}/pyenv-win-backup"
$CurrentVersion = Get-CurrentVersion
If ($CurrentVersion) {
Write-Host "pyenv-win $CurrentVersion installed."
$LatestVersion = Get-LatestVersion
If ($CurrentVersion -eq $LatestVersion) { Write-Host "No updates available."; exit }
Else { Write-Host "New version available: $LatestVersion. Updating..."; Write-Host "Backing up existing Python installations..."; $FoldersToBackup = "install_cache", "versions", "shims"; ForEach ($Dir in $FoldersToBackup) { If (-not (Test-Path $BackupDir)) { New-Item -ItemType Directory -Path $BackupDir }; Move-Item -Path "${PyEnvWinDir}/${Dir}" -Destination $BackupDir }; Write-Host "Removing $PyEnvDir..."; Remove-Item -Path $PyEnvDir -Recurse }
}
New-Item -Path $PyEnvDir -ItemType Directory
$DownloadPath = "$PyEnvDir\pyenv-win.zip"
(New-Object System.Net.WebClient).DownloadFile("https://github.com/pyenv-win/pyenv-win/archive/master.zip", $DownloadPath)
Start-Process -FilePath "powershell.exe" -ArgumentList @( "-NoProfile", "-Command `"Microsoft.PowerShell.Archive\Expand-Archive -Path \`"$DownloadPath\`" -DestinationPath \`"$PyEnvDir\`"" ) -NoNewWindow -Wait
Move-Item -Path "$PyEnvDir\pyenv-win-master\*" -Destination "$PyEnvDir"
Remove-Item -Path "$PyEnvDir\pyenv-win-master" -Recurse
Remove-Item -Path $DownloadPath
[System.Environment]::SetEnvironmentVariable('PYENV', "${PyEnvWinDir}\", "User")
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT', "${PyEnvWinDir}\", "User")
[System.Environment]::SetEnvironmentVariable('PYENV_HOME', "${PyEnvWinDir}\", "User")
$PathParts = [System.Environment]::GetEnvironmentVariable('PATH', "User") -Split ";"
$NewPathParts = $PathParts.Where{ $_ -ne $BinPath }.Where{ $_ -ne $ShimsPath }
$NewPathParts = ($BinPath, $ShimsPath) + $NewPathParts
$NewPath = $NewPathParts -Join ";"
[System.Environment]::SetEnvironmentVariable('PATH', $NewPath, "User")
If (Test-Path $BackupDir) { Write-Host "Restoring Python installations..."; Move-Item -Path "$BackupDir/*" -Destination $PyEnvWinDir }
If ($? -eq $True) { Write-Host "pyenv-win is successfully installed. You may need to close and reopen your terminal before using it." } Else { Write-Host "pyenv-win was not installed successfully. If this issue persists, please open a ticket: https://github.com/pyenv-win/pyenv-win/issues." }
}
Main
列出所有官方可安装的 Python 版本（含 3.x、2.x、anaconda 等）：
pyenv install --list
筛选常用版本（比如只看 3.10 开头）：
pyenv install -l | findstr "3.10" # Windows
pyenv install -l | grep "3.10" # Linux/macOS
# 示例：安装 Python 3.10.11
pyenv install 3.10.11
列出本地所有已安装的 Python 版本（* 标记当前生效版本）：
pyenv versions
pyenv 支持 3 种维度的版本切换，优先级：临时版本 > 局部版本 > 全局版本。
设置后整个系统默认使用该版本（重启终端生效）：
# 示例：设置全局版本为 3.10.11
pyenv global 3.10.11
针对项目目录单独设置版本（会在目录下生成 .python-version 文件，提交到 Git 可同步团队版本）：
# 进入项目目录
cd %USERPROFILE%\my_project
# 设置局部版本为 3.9.18
pyenv local 3.9.18
取消局部版本：
pyenv local --unset
仅在当前终端窗口生效，关闭后恢复：
# 示例：临时使用 3.8.19
pyenv shell 3.8.19
取消临时版本：
pyenv shell --unset
设置版本后，执行以下命令确认：
# 查看 Python 版本（pyenv 接管后的版本）
python --version
# 查看 pip 版本（对应当前 Python）
pip --version
# 示例：卸载 3.8.19
pyenv uninstall 3.8.19
| 命令 | 作用 |
|---|---|
pyenv rehash | 重新生成版本映射（安装 / 卸载版本后建议执行，避免命令找不到） |
pyenv which python | 查看当前 python 命令的实际路径 |
pyenv root | 查看 pyenv 的安装根目录（Windows 默认：% USERPROFILE%.pyenv） |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online