> 技术文档 > Windows 创建并激活 Python 虚拟环境venv_windows 激活venv

Windows 创建并激活 Python 虚拟环境venv_windows 激活venv



Windows 创建并激活 Python 虚拟环境

1. 进入项目根目录
cd /d api(你的项目路径)

📝 注意:/d 参数可切换不同盘符的目录

2. 创建虚拟环境
python -m venv .venv

✅ 最佳实践:

  • 推荐使用 .venv 作为虚拟环境目录名(隐藏目录,且被多数 IDE 识别)
  • 如果系统有多个 Python 版本,明确指定版本:
    python3.9 -m venv .venv # 或 py -3.9 -m venv .venv
3. 激活虚拟环境
.venv\\Scripts\\activate

⚠️ 常见问题:

  • 报错\"禁止运行脚本\":执行以下命令后重试:
    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 如果使用 PowerShell:
    .venv\\Scripts\\Activate.ps1
4. 验证激活

激活后命令行应显示虚拟环境标记:

(.venv) C:\\path\\to\\api>

检查 Python 路径:

where python

应指向 .venv\\Scripts\\python.exe

5. 退出虚拟环境
deactivate

扩展说明

1. 安装依赖包

激活环境后安装项目依赖:

pip install -r requirements.txt
2. 快速激活技巧

在项目根目录创建 activate.cmd 文件,内容:

@echo offcmd /k \".\\.venv\\Scripts\\activate\"

双击即可快速激活环境

3. 删除虚拟环境

直接删除 .venv 文件夹即可