Python项目需环境隔离，推荐venv+requirements.txt（小项目）或pyproject.toml+pip-tools（中大型项目），配合pyenv、Docker实现多版本与容器化部署。

Python项目开发中，不同项目常依赖不同版本的包，甚至同一项目在开发、测试、生产环境也需要隔离依赖。直接用全局Python环境容易引发冲突，因此必须采用环境隔离方案。

使用venv创建轻量级虚拟环境

Python 3.3+ 自带 venv 模块，无需额外安装，适合快速搭建干净、独立的运行环境。

• 在项目根目录执行：python -m venv venv（生成名为 venv 的文件夹）
• 激活环境：source venv/bin/activate（Linux/macOS）或 venv\Scripts\activate（Windows）
• 激活后命令行前缀会显示环境名，此时 pip install 安装的包仅对当前环境生效
• 退出环境用 deactivate；删除 venv 文件夹即可彻底清理

用requirements.txt统一管理依赖

虚拟环境本身不记录已装包列表，需手动导出和还原，requirements.txt 是最通用的依赖声明方式。

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

• 导出当前环境所有包（含版本）：pip freeze > requirements.txt
• 在新环境还原依赖：pip install -r requirements.txt
• 推荐在导出前先升级 pip：python -m pip install --upgrade pip，避免因旧版 pip 导致冻结不准确
• 可拆分多个文件，如 requirements-dev.txt 用于开发依赖（pytest、black等），用 -r requirements.txt 引入主依赖

用pyproject.toml + pip-tools实现精准依赖控制

当项目需要严格控制传递依赖版本（例如规避安全漏洞或兼容性问题），pip-tools 提供更可靠的锁定机制。

立即学习“Python免费学习笔记（深入）”；

• 在 pyproject.toml 中用 [build-system] 和 [project] 声明直接依赖（类似 setup.py 的 modern 替代）
• 安装 pip-tools：pip install pip-tools
• 将直接依赖写入 requirements.in，再运行 pip-compile requirements.in 生成锁定版 requirements.txt
• 每次修改 requirements.in 后重新 compile，确保所有环境安装完全一致的依赖树

按场景选择合适工具组合

没有“万能方案”，应根据团队规模、CI/CD流程和协作需求灵活搭配：

• 个人小项目：venv + requirements.txt 足够清晰可控
• 中大型团队或需审计的项目：pyproject.toml + pip-tools + Git 提交锁定文件，提升可复现性
• 多Python版本测试：配合 pyenv 管理解释器版本，再为每个版本创建独立 venv
• 容器化部署：Dockerfile 中明确指定 Python 版本并基于 venv 构建，避免污染基础镜像