Python 虚拟环境 venv 入门指南

什么是 venv？

venv 是 Python 3.3+ 自带的标准库模块，用于创建轻量级的“虚拟环境”。每个虚拟环境拥有独立的 Python 解释器和包安装目录，从而实现不同项目之间的依赖隔离。

为什么需要虚拟环境？

• 避免不同项目之间的包版本冲突（例如：项目A需要 Django 3.x，项目B需要 Django 4.x）
• 保持全局 Python 环境干净，防止意外污染
• 便于复现开发环境（配合 requirements.txt）
• 提升团队协作效率与部署一致性

快速上手：5 步创建并使用 venv

1. 打开终端（命令提示符 / PowerShell / Terminal）
2. 进入你的项目目录：

   cd your_project_folder

3. 创建虚拟环境（以 myenv 为例）：

   python -m venv myenv

4. 激活虚拟环境：
   • Windows (CMD/PowerShell):

     myenv\Scripts\activate

   • macOS / Linux:

     source myenv/bin/activate

5. 开始使用！ 激活后，命令行前缀会显示环境名（如 (myenv)），此时使用 pip install 安装的包仅限当前环境。

   (myenv) $ pip install requests

常用操作命令

• 查看当前 Python 路径： which python（Linux/macOS）或 where python（Windows）
• 导出依赖列表： pip freeze > requirements.txt
• 从文件安装依赖： pip install -r requirements.txt
• 退出虚拟环境： deactivate
• 删除虚拟环境： 直接删除整个 myenv 文件夹即可

常见问题

Q：venv 和 virtualenv 有什么区别？
A：venv 是 Python 78TP标准库的一部分，功能更精简；virtualenv 是第三方工具，功能更丰富（如支持旧版 Python）。对于 Python 3.3+ 项目，推荐优先使用 venv。

Q：激活后为什么命令行没有变化？
A：某些终端（如 PowerShell）可能因执行策略限制无法运行脚本。可尝试在 PowerShell 中先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser