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

一、最佳实践

1、创建项目目录
bash 复制代码
mkdir -p ~/Desktop/code/python/test
cd ~/Desktop/code/python/test
2、进入项目目录后,指定该项目使用的python版本
bash 复制代码
pyenv local 版本号

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

3、在项目目录下,使用uv创建独立环境,以达到各项目依赖独立、避免多项目依赖冲突的目的
bash 复制代码
uv venv

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

注:安装uv
bash 复制代码
pip install uv

# 验证安装成功
uv --version
# 成功会显示类似:uv 0.8.16 (2de677b0d 2025-09-09)
4、激活独立虚拟环境
bash 复制代码
source .venv/bin/activate

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

如果想要退出虚拟环境命令:
bash 复制代码
deactivate
注意事项

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

bash 复制代码
# 安装 direnv
brew install direnv # macOS
sudo apt install direnv # Linux

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

bash 复制代码
vi .envrc

source .venv/bin/activate

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

5、验证环境是否正确激活
bash 复制代码
# 查看当前Python路径(应指向.venv内)
which python
# 查看已安装依赖(应显示在.venv内)
uv pip list
6、安装项目依赖
bash 复制代码
uv pip install requests

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

7、导出依赖清单到 requirements.txt,方便后续迁移或团队协作
bash 复制代码
uv pip freeze > requirements.txt

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

1、进入项目目录,删除旧的虚拟环境
bash 复制代码
cd 项目目录
rm -rf .venv  # 删除旧的虚拟环境
2、指定python版本
bash 复制代码
pyenv local 版本号
3、重新创建虚拟环境
bash 复制代码
uv venv
4、激活虚拟环境
bash 复制代码
source .venv/bin/activate 
5、验证环境是否正确激活
bash 复制代码
# 查看当前Python路径(应指向.venv内)
which python
# 查看已安装依赖(应显示在.venv内)
uv pip list
6、重新安装依赖
bash 复制代码
uv pip install -r requirements.txt # 如果之前导出过requirements.txt
或
uv pip install requests

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

相关推荐
MediaTea29 分钟前
Python IDE:Spyder
开发语言·ide·python
B站_计算机毕业设计之家1 小时前
大数据 Python小说数据分析平台 小说网数据爬取分析系统 Django框架 requests爬虫 Echarts图表 17k小说网 (源码)✅
大数据·爬虫·python·机器学习·数据分析·可视化·小说
都是些老物件1 小时前
TensorFlow中的掩码传递
人工智能·python·tensorflow
理想三旬2 小时前
网络爬虫(上)
python
zzywxc7872 小时前
大模型落地实践指南:从技术路径到企业级解决方案
java·人工智能·python·microsoft·golang·prompt
小小测试开发3 小时前
给贾维斯加“手势控制”:从原理到落地,打造多模态交互的本地智能助
人工智能·python·交互
Python×CATIA工业智造3 小时前
Python数据汇总与统计完全指南:从基础到高阶实战
python·pycharm
MoRanzhi12036 小时前
2. Pandas 核心数据结构:Series 与 DataFrame
大数据·数据结构·人工智能·python·数据挖掘·数据分析·pandas
小钱c77 小时前
Python利用ffmpeg实现rtmp视频拉流和推流
python·ffmpeg·音视频
合作小小程序员小小店8 小时前
桌面预测类开发,桌面%性别,姓名预测%系统开发,基于python,scikit-learn机器学习算法(sklearn)实现,分类算法,CSV无数据库
python·算法·机器学习·scikit-learn·sklearn