一、最佳实践
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 .envrc
source .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