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

相关推荐
应用市场2 小时前
构建自定义命令行工具 - 打造专属指令体
开发语言·windows·python
东方佑2 小时前
从字符串中提取重复子串的Python算法解析
windows·python·算法
Dfreedom.2 小时前
一文掌握Python四大核心数据结构:变量、结构体、类与枚举
开发语言·数据结构·python·变量·数据类型
一半烟火以谋生2 小时前
Python + Pytest + Allure 自动化测试报告教程
开发语言·python·pytest
叶子丶苏4 小时前
第八节_PySide6基本窗口控件_按钮类控件(QAbstractButton)
python·pyqt
百锦再4 小时前
对前后端分离与前后端不分离(通常指服务端渲染)的架构进行全方位的对比分析
java·开发语言·python·架构·eclipse·php·maven
Blossom.1185 小时前
把AI“刻”进玻璃:基于飞秒激光量子缺陷的随机数生成器与边缘安全实战
人工智能·python·单片机·深度学习·神经网络·安全·机器学习
Kratzdisteln5 小时前
【Python OOP Diary 1.1】题目二:简单计算器,改错与优化
python·面向对象编程
小白银子5 小时前
零基础从头教学Linux(Day 53)
linux·运维·python
skywalk81636 小时前
基于频域的数字盲水印blind-watermark
linux·开发语言·python