Python 虚拟环境与依赖管理最佳实践

引言

在 Python 开发中，直接将第三方库安装在全局环境会导致版本冲突和依赖污染。本文将结合华为云开发者社区的实战经验，介绍如何使用内置的 venv 和标准工具规范化管理项目环境。

创建与激活虚拟环境

为每个项目独立创建虚拟环境是规范开发的第一步。在项目根目录下执行以下命令：

python3 -m venv .venv
source .venv/bin/activate

激活后，终端提示符会发生变化，此时所有通过 pip 安装的包都会被隔离在当前项目的 .venv 目录中，不会影响系统全局环境。

依赖冻结与版本锁定

为了保证团队协作和云端部署时环境的一致性，必须将当前环境的精确依赖版本导出到 requirements.txt 文件中：

pip freeze > requirements.txt

当其他开发者或 CI/CD 流水线拿到代码后，只需执行以下命令即可一键还原完全相同的依赖版本：

pip install -r requirements.txt

常见误区与避坑指南

很多开发者习惯直接用 pip install package 后盲目执行 pip freeze，这往往会把本地调试时临时安装无关包一并导进去。建议养成良好习惯：定期使用 pip list 审查依赖，并结合 .gitignore 忽略 .venv/ 目录，避免将大体积的虚拟环境文件提交到 Git 仓库。

可操作建议： 立即检查你当前的项目，为它配置一个独立的 .venv 并通过 requirements.txt 锁定依赖版本。