如何设置Python虚拟环境

设置 Python 虚拟环境的实用指南

一 使用内置 venv 快速上手

• 检查 Python 版本：在终端运行 python --version 或 python3 --version，确认已安装 Python 3.3+。
• 创建虚拟环境：在项目目录执行 python -m venv venv（将 venv 替换为你的环境名，如 .venv）。
• 激活环境：
  • Windows：执行 venv\Scripts\activate（PowerShell 可用 .\venv\Scripts\Activate.ps1）。
  • macOS/Linux：执行 source venv/bin/activate。
• 验证激活：命令行前缀出现 (venv) 即表示成功。
• 安装依赖：在激活状态下使用 pip install 包名；建议优先使用国内镜像源加速，例如：
  • 临时：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名
  • 全局配置：pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
• 导出/复现依赖：
  • 导出：pip freeze > requirements.txt
  • 复现：pip install -r requirements.txt
• 退出环境：执行 deactivate。
• 删除环境：直接删除虚拟环境目录（如 rm -rf venv 或 Windows 资源管理器删除）。

二 多版本 Python 与不同环境的切换

• 指定版本创建：
  • python3.10 -m venv venv310
  • python3.8 -m venv venv38
• 激活对应环境后，使用 python --version 与 pip --version 校验解释器与包路径是否一致。
• 跨平台激活命令保持一致：
  • Windows：venv38\Scripts\activate
  • macOS/Linux：source venv38/bin/activate
• 如需在同一机器管理多个 Python 版本，可配合 pyenv 安装与切换版本，再用 venv 为每个项目创建隔离环境。

三 常用工具对比与选型建议

四 常见问题与排查

• Linux 提示找不到 venv 模块：在 Debian/Ubuntu 系执行 sudo apt install python3-venv 安装 venv 支持。
• Windows 激活失败或策略限制：以管理员身份运行 PowerShell，或执行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass 后再激活；也可改用 venv\Scripts\activate.bat。
• 多版本并存与解释器路径混乱：用 which python（macOS/Linux）或 where python（Windows）确认解释器路径；为每个项目单独创建并激活对应 venv。
• VSCode 使用虚拟环境：按 Ctrl+Shift+P → 输入并选择 Python: Select Interpreter → 选择虚拟环境的解释器路径（如 .venv/Scripts/python.exe 或 .venv/bin/python）。