【python】windows下使用pyenv+uv进行python版本及环境变量管理

一、pyenv

(一)、pyenv-win安装(windows版本)

1.手动安装

(1).下载源码包

访问 pyenv-win GitHub 仓库，点击「Code」→「Download ZIP」，下载压缩包。

(2).解压并移动文件

解压下载的 ZIP 文件，得到 pyenv-win-master 文件夹
将文件夹重命名为 pyenv-win
移动到路径：C:\Users<你的用户名>.pyenv\pyenv-win
（需手动创建 .pyenv 文件夹，<你的用户名> 替换为实际系统用户名，例如 C:\Users\张三.pyenv\pyenv-win）

(3).配置环境变量

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在「用户变量」区域点击「新建」，添加：
变量名：PYENV
变量值：C:\Users<你的用户名>.pyenv\pyenv-win（替换为实际路径）
编辑用户变量中的 Path，添加两条路径：
%PYENV%\bin
%PYENV%\shims
点击「确定」保存所有设置。

(4).验证安装是否成功

bash 复制代码

pyenv --version

（二）、常用指令

bash 复制代码

# 查看可安装的 Python 版本（筛选正式版）
pyenv install --list | findstr /v "b"  # CMD 中使用
# 或 pyenv install --list | Select-String -Pattern "^\d+\.\d+\.\d+$"  # PowerShell 中使用

# 安装指定版本（例如 3.11.6）
pyenv install 3.11.6

# 查看已安装的版本
pyenv versions

# 设置全局默认版本（所有终端生效）
pyenv global 3.11.6

# 设置当前项目的局部版本（仅当前文件夹生效）
pyenv local 3.10.12

# 卸载某个版本
pyenv uninstall 3.10.12

二、uv使用

1. 安装包

bash 复制代码

# 安装单个包
uv pip install requests

# 安装指定版本
uv pip install requests==2.31.0

# 从 requirements.txt 安装
uv pip install -r requirements.txt

# 安装到全局环境（不推荐，需退出虚拟环境）
uv pip install --system requests

2. 卸载包

bash 复制代码

uv pip uninstall requests

3.升级包

bash 复制代码

# 升级单个包
uv pip upgrade requests

# 升级所有包
uv pip upgrade --all

4.导出依赖

bash 复制代码

# 生成 requirements.txt（类似 pip freeze）
uv pip freeze > requirements.txt

# 生成精确的锁定文件（推荐，确保依赖一致性）
uv pip compile requirements.txt -o requirements.lock

5.依赖解析与锁定

bash 复制代码

# 生成锁定文件（基于 pyproject.toml）
uv lock

# 根据锁定文件安装依赖
uv sync