跳到主要内容

venv

venv 为每个项目创建独立的 Python 环境，避免不同项目的依赖版本互相污染。虚拟环境本身不应提交到 Git，通常目录名为 .venv。

创建和激活​

python -m venv .venv

macOS/Linux：

source .venv/bin/activate

Windows PowerShell：

.venv\\Scripts\\Activate.ps1

激活后，python 和 pip 指向环境内的解释器。可用 python -c "import sys; print(sys.executable)" 验证。退出环境：deactivate。

安装与锁定依赖​

python -m pip install --upgrade pip
python -m pip install requests
python -m pip freeze > requirements.txt
python -m pip install -r requirements.txt

使用 python -m pip 可确保 pip 属于当前解释器。团队项目应提交明确的依赖文件；本仓库使用 pnpm 管理 JavaScript 依赖，Python 虚拟环境只适用于 Python 工具或示例。

运行、升级和删除​

无需激活也可以直接调用环境中的解释器：.venv/bin/python script.py。升级依赖后重新生成依赖文件并运行测试。虚拟环境是可重建产物，遇到损坏时删除 .venv 后按依赖文件重建即可；不要把它复制到另一台机器，路径和解释器可能失效。

常见问题​

  • 把 .venv/ 写入 .gitignore，避免提交大量二进制文件。
  • IDE 中选择项目的 .venv 解释器，否则编辑器运行的可能是系统 Python。
  • 激活脚本执行策略受操作系统限制；不能激活时可直接使用环境内的 Python 路径。
  • venv 只隔离 Python 包，不隔离系统库、数据库或环境变量；敏感配置仍应使用安全的配置管理方式。