Python虚拟环境创建与激活教程

Python的venv虚拟环境创建与激活看似简单，实则暗藏诸多易被忽视的关键细节：必须显式指定路径（如`python -m venv myenv`），严禁使用`.`或中文/空格路径，避免覆盖项目文件或引发编码错误；激活后不能仅凭终端前缀判断成功，务必通过`sys.executable`和`pip --version`验证Python和pip是否真正指向虚拟环境内部；不同系统与shell类型（zsh、PowerShell等）对激活命令有特殊要求，且每次新开终端都需重新激活——这不是缺陷，而是venv轻量隔离设计的核心体现。掌握这些实操要点，才能真正避开“看似激活实则无效”的坑，确保依赖隔离万无一失。

venv 创建命令必须指定路径，不能只写 python -m venv

直接运行 python -m venv 会报错：venv: error: the following arguments are required: ENV_DIR。标准库要求你明确告诉它把环境建在哪，比如：python -m venv myenv。路径可以是相对路径（如 ./venv）、绝对路径（如 /opt/myproject/venv），但不能留空或只用点号 .——. 会被当成当前目录名，导致后续激活失败或 pip 安装混乱。

常见误操作：

• 在项目根目录下执行 python -m venv .：这会让 Python 把所有虚拟环境文件直接铺平到当前目录，覆盖 pyproject.toml 或 setup.py 等同名文件
• 用中文路径或含空格路径（如 python -m venv 我的环境）：Windows 下可能触发编码错误，macOS/Linux 下 shell 解析易出错
• 重复创建同名目录（如 python -m venv venv 两次）：第二次会失败并提示 Directory 'venv' already exists，需手动删掉或加 --clear

激活方式因系统而异，shell 类型决定用哪个脚本

虚拟环境创建后，激活脚本放在 myenv/bin/activate（Linux/macOS）或 myenv\Scripts\activate.bat（Windows cmd）/myenv\Scripts\Activate.ps1（PowerShell）。关键不是“怎么输命令”，而是“输完之后终端提示符有没有变”——变了才说明成功。

容易卡住的地方：

• macOS / Linux 用户习惯用 source venv/bin/activate，但若用的是 zsh 且没配置 shopt -s expand_aliases，某些旧版 venv 可能无法识别 alias；稳妥做法始终用 source ./venv/bin/activate
• Windows PowerShell 默认禁止执行本地脚本，运行 Activate.ps1 会报错：File Activate.ps1 cannot be loaded because running scripts is disabled。临时解决：以管理员身份运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• 激活后执行 which python（macOS/Linux）或 where python（Windows）应指向虚拟环境内的解释器，否则说明没生效

pip 和 python 指向是否正确，得看 sys.executable 和 pip --version

光看终端前缀（如 (myenv) $）不够，有些终端主题会伪造括号提示。真正验证隔离是否生效，要查两个地方：

• 运行 python -c "import sys; print(sys.executable)"，输出必须是类似 /path/to/myenv/bin/python（macOS/Linux）或 C:\path\to\myenv\Scripts\python.exe（Windows）
• 运行 pip --version，输出里必须包含 from /path/to/myenv/lib/python3.x/site-packages，而不是系统级路径（如 /usr/local/lib/python3.x/site-packages）
• 如果 pip install requests 后，在系统 Python 里还能 import requests，说明压根没激活，或者激活后又开了新终端窗口没重新激活

退出虚拟环境只需 deactivate，但别依赖 IDE 自动管理

deactivate 是 venv 内置命令，不带参数、不加路径、不分大小写（Deactivate 不行，但 deactivate 总是对的）。它会还原 PYTHONPATH、PATH 和提示符。但要注意：

• VS Code、PyCharm 等 IDE 有时会“记住”上次选的解释器，即使你终端里已 deactivate，IDE 内置终端仍可能继续用虚拟环境的 Python——得关掉终端再重开，或手动选解释器
• 某些 CI 脚本（如 GitHub Actions）用 run: | 多行命令时，每行都是独立 shell，source venv/bin/activate 只对当行生效；必须写成 source venv/bin/activate && python -m pytest
• 删除虚拟环境只要 rm -rf myenv（macOS/Linux）或 rmdir /s myenv（Windows），不需要额外清理注册表或全局配置

实际用的时候，最常被忽略的是：**激活不是一次性的，每个新打开的终端都要单独激活**。哪怕你刚在另一个窗口里跑通了，换一个 tab 就得重来。这不是 bug，是设计使然——venv 的轻量，就体现在它不挂钩系统、不改全局状态，全靠 shell 环境变量临时注入。

到这里，我们也就讲完了《Python虚拟环境创建与激活教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！