Windows 新装系统下 Python venv 激活失败问题详解

内容纲要

—— PowerShell Execution Policy 导致的 Activate.ps1 报错

在 Windows 新装系统中，使用 Python 3.10 创建虚拟环境（venv）后，很多开发者会在激活虚拟环境或 VS Code 选择解释器（Select Interpreter）时，遇到如下错误：

无法加载文件 ...\Activate.ps1，因为在此系统上禁止运行脚本。
PSSecurityException

本文将从问题现象、根本原因、安全解决方案、最佳实践四个层面，对该问题进行完整解析，帮助你一次解决、永久不踩坑。

一、问题现象

典型场景如下：

操作系统：Windows（新装）
Python 版本：3.10
已成功创建虚拟环境：

python -m venv .venv

尝试激活虚拟环境：

.\.venv\Scripts\Activate.ps1

PowerShell 报错：

& : 无法加载文件 Activate.ps1，因为在此系统上禁止运行脚本。
有关详细信息，请参阅 about_Execution_Policies。

或在 VS Code 中执行 Python: Select Interpreter 时直接失败。

二、根本原因分析（核心知识点）

1. venv 在 Windows 下是如何“激活”的？

在 Windows 系统中：

Linux / macOS 使用 source activate
Windows 使用 PowerShell 脚本 Activate.ps1

本质上，激活 venv = 执行一个 .ps1 脚本。

2. PowerShell 的 Execution Policy 是什么？

PowerShell 默认启用 脚本执行策略（Execution Policy），用于防止恶意脚本执行。

新装 Windows 的默认策略通常是：

Restricted

含义是：

❌ 禁止运行任何 .ps1 脚本
包括 Python venv、Node、npm、conda、Git 相关脚本

因此，错误并不是 Python 或 venv 的问题，而是操作系统级别的安全策略拦截。

三、推荐解决方案（安全、标准、长期有效）

✅ 推荐方案：仅对当前用户放行脚本执行

在 普通 PowerShell（不需要管理员） 中执行：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

确认时输入：

然后：

关闭当前 PowerShell
重新打开终端
再次激活虚拟环境：

.\.venv\Scripts\Activate.ps1

这个方案为什么是“最佳实践”？

维度	说明
Scope	`CurrentUser`（不影响系统、不影响公司策略）
安全性	本地脚本可执行，网络脚本需签名
适用性	Python / Node / AI / 后端开发通用
可维护性	一次配置，长期生效

这是 Windows 开发环境的行业通用配置。

四、验证是否配置成功（可选）

执行：

Get-ExecutionPolicy -List

理想结果应为：

Scope        ExecutionPolicy
-----        ---------------
CurrentUser  RemoteSigned
LocalMachine Restricted

说明：

系统级安全仍然存在
当前用户具备开发所需的脚本权限

五、不推荐但可临时使用的方案

❌ 一次性绕过（不建议）

powershell -ExecutionPolicy Bypass

问题在于：

每次开新终端都要重新执行
VS Code 仍然可能报错
不利于长期开发环境维护

六、Windows + Python venv 的两个常见误区

误区 1：激活命令写错

PowerShell 正确方式：

.\.venv\Scripts\Activate.ps1

不是：

activate
source activate（Linux 专用）

误区 2：VS Code 必须手动 activate？

实际上不需要。

推荐流程：

打开 VS Code
Ctrl + Shift + P
执行：Python: Select Interpreter
选择：

.venv\Scripts\python.exe

此后：

VS Code 自动使用该解释器
终端无需手动 activate
调试 / 运行全部走 venv

七、总结

一句话结论

Windows 新装系统下 Python venv 激活失败，99% 是 PowerShell Execution Policy 导致的，而不是 Python 问题。

最终解决方案

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

这是每一个 Windows 上从事 Python / AI / 后端开发的人，都必须完成的一次性环境配置。