Windows 下创建与激活 Python 虚拟环境
在 Windows 开发中,隔离项目依赖是保持环境整洁的关键。使用 venv 模块可以轻量级地实现这一目标,无需安装额外的包管理器。
1. 定位项目目录
首先打开终端(CMD 或 PowerShell),进入你的项目根目录。如果涉及盘符切换,记得加上 /d 参数:
cd /d api(你的项目路径)
💡 提示:
/d允许跨盘符跳转,避免路径错误。
2. 初始化虚拟环境
在项目目录下执行以下命令创建 .venv 文件夹。这是最佳实践,因为隐藏目录名能被大多数 IDE 自动识别并忽略。
python -m venv .venv
如果你的机器安装了多个 Python 版本,建议显式指定版本以避免混淆:
python3.9 -m venv .venv
# 或者
py -3.9 -m venv .venv
3. 激活虚拟环境
激活后,命令行前缀会显示 (venv) 字样,表示当前会话已切换到隔离环境。
CMD 用户:
.venv\Scripts\activate
PowerShell 用户:
.venv\Scripts\Activate.ps1
⚠️ 常见问题处理: 如果在 PowerShell 中遇到'禁止运行脚本'的错误,通常是因为执行策略限制。只需在当前用户作用域下放宽限制即可:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
执行完上述命令后,重新尝试激活步骤。
4. 验证环境状态
激活成功后,可以通过检查 Python 路径确认是否指向了虚拟环境:
where python
输出应包含 .venv\Scripts\python.exe 路径。如果指向系统全局 Python,说明激活未生效。
5. 安装依赖与清理
环境就绪后,直接安装项目所需的依赖包:
pip install -r requirements.txt
不再需要时,输入 deactivate 即可退出虚拟环境。若需彻底删除,直接移除 .venv 文件夹即可。
6. 快速启动技巧
为了方便日常开发,可以在项目根目录创建一个 activate.cmd 批处理文件,内容如下:
@echo off
cmd /k ".\.venv\Scripts\activate"
双击该文件即可一键激活环境,省去手动输入命令的麻烦。

