python版本管理和依赖管理的最佳实践，pyenv + uv

一、最佳实践

1、创建项目目录

mkdir -p ~/Desktop/code/python/test
cd ~/Desktop/code/python/test

2、进入项目目录后，指定该项目使用的python版本

pyenv local 版本号

执行该命令后，会在项目目录下生成.python-version 文件，其中记录了指定的Python版本（例如 3.12）

3、在项目目录下，使用uv创建独立环境，以达到各项目依赖独立、避免多项目依赖冲突的目的

uv venv

执行该命令后，项目目录下会生成.venv目录，类似PHP语言中的vendor目录

注：安装uv

pip install uv# 验证安装成功
uv --version
# 成功会显示类似：uv 0.8.16 (2de677b0d 2025-09-09)

4、激活独立虚拟环境

source .venv/bin/activate

执行该命令后，命令行工具前会有一个 (.venv) 标识

如果想要退出虚拟环境命令：

deactivate

注意事项

每次开启新窗口后，都要重新执行一下命令 source .venv/bin/activate激活虚拟环境，否则会使用全局的python版本和依赖，如果不想每次打开新窗口后都执行该命令，可以使用 direnv 工具

# 安装 direnv
brew install direnv # macOS
sudo apt install direnv # Linux

在项目目录下创建 .envrc 文件，写入 source .venv/bin/activate;

vi .envrcsource .venv/bin/activate

执行 direnv allow 授权，之后进入项目目录会自动激活虚拟环境，离开目录会自动退出。

5、验证环境是否正确激活

# 查看当前Python路径（应指向.venv内）
which python
# 查看已安装依赖（应显示在.venv内）
uv pip list

6、安装项目依赖

uv pip install requests

依赖会被安装在 项目目录/.venv/lib/python3.12（之前指定的python版本）/site-packages/requests/

7、导出依赖清单到 requirements.txt，方便后续迁移或团队协作

uv pip freeze > requirements.txt

二、想要更改项目使用的python版本如何做

1、进入项目目录，删除旧的虚拟环境

cd 项目目录
rm -rf .venv  # 删除旧的虚拟环境

2、指定python版本

pyenv local 版本号

3、重新创建虚拟环境

uv venv

4、激活虚拟环境

source .venv/bin/activate 

5、验证环境是否正确激活

# 查看当前Python路径（应指向.venv内）
which python
# 查看已安装依赖（应显示在.venv内）
uv pip list

6、重新安装依赖

uv pip install -r requirements.txt # 如果之前导出过requirements.txt
或
uv pip install requests

原文链接：python版本管理和依赖管理的最佳实践，pyenv + uv