[虚拟环境]venv工具(实战)

14 阅读2分钟

关于虚拟环境的创建与项目绑定,没有绝对唯一的“正确”方式,但根据Python社区的最佳实践,推荐先创建项目目录,然后进入该项目目录, 在项目的根目录下创建虚拟环境

以下是详细解释和对比:

1/推荐方式:先创建项目,后在项目内创建虚拟环境

# 1. 创建项目目录
mkdir my_project
cd my_project

# 2. 在项目根目录下创建虚拟环境
python -m venv venv_vir_test1   # 或 .venv_vir_test1

# 3. 激活虚拟环境
# Windows:
venv_vir_test1\Scripts\activate
# macOS/Linux:
source venv_vir_test1/bin/activate

# 4. 开始开发,安装依赖等

优点:

  1. 项目自包含 - 虚拟环境与项目代码在同一目录结构下
  2. 便于版本控制 - 可将 .gitignore 添加 venv/.venv/
  3. 易于识别 - 打开项目就知道有对应的虚拟环境
  4. 路径简单 - 激活命令相对简单,无需记绝对路径
  5. 便于管理 - 删除项目时,虚拟环境一并删除,不会留下孤儿环境

2/另一种方式:先创建虚拟环境,后关联项目

# 1. 在某个集中位置创建虚拟环境
python -m venv ~/venvs/my_project_env

# 2. 创建项目目录
mkdir ~/projects/my_project
cd ~/projects/my_project

# 3. 激活虚拟环境(需要完整路径)
source ~/venvs/my_project_env/bin/activate

适用场景:

  • 需要在多个项目间共享同一个虚拟环境
  • 使用工具如 virtualenvwrapperpipenv 管理环境
  • 磁盘空间紧张,希望虚拟环境集中存储

3/实际工作流程建议

使用项目内虚拟环境的标准流程:

# 1. 创建项目结构
my_project/
├── .gitignore      # 忽略 venv/
├── requirements.txt # 项目依赖
├── src/           # 源代码
└── venv/          # 虚拟环境(不提交到版本控制)

# 2. 创建并激活环境后,安装依赖
pip install -r requirements.txt

自动化激活的提示

在项目根目录创建 .envrc(使用direnv)或配置IDE:

# VS Code 会自动检测项目中的 .venv 或 venv 目录
# PyCharm: File → Settings → Project → Python Interpreter → 选择 venv/python.exe

4/总结建议

方面项目内虚拟环境集中式虚拟环境
初学者友好度⭐⭐⭐⭐⭐⭐⭐
项目管理⭐⭐⭐⭐⭐⭐⭐
多项目共享不适合⭐⭐⭐⭐
团队协作⭐⭐⭐⭐⭐⭐⭐
IDE支持自动检测需手动配置

推荐使用项目内虚拟环境,特别是:

  • 独立项目开发
  • 团队协作
  • 使用版本控制系统
  • 需要清晰的项目边界

特殊情况考虑集中式环境

  • 多个相似项目需要相同环境
  • 使用高级虚拟环境管理工具
  • 有特殊的管理需求

大多数Python教程、文档和工具(如Django、Flask的官方指南)都默认推荐项目内虚拟环境的方式。