虚拟环境python.exe调用全局Python实例问题排查与解决请求

问题描述 #

使用virtualenv在项目目录创建.venv虚拟环境，VSCode已将解释器设置为该虚拟环境，但激活虚拟环境后运行脚本时，虚拟环境的python.exe会生成调用全局Python实例的子进程，即使激活后PATH首位是虚拟环境的Scripts目录。

复现步骤（Windows 10系统） #

• 为所有用户安装Python 3.11
• 执行pip install virtualenv
• 进入项目目录
• 执行virtualenv .venv
• 在生成的activate.ps1脚本末尾添加$env:PYTHONPATH = ".\src\WPL-API;$env:PYTHONPATH"
• 启动VSCode并打开该项目目录
• 将Python解释器设置为('.venv': venv)而非全局版本
• 打开新的PowerShell终端，触发更新后的activate.ps1脚本
• 在激活的终端中执行python命令运行目标脚本

解决方法 #

1. 确认虚拟环境Python文件的有效性 #

打开虚拟环境的.venv\Scripts目录，检查python.exe是否为独立可执行文件（而非快捷方式）。如果是快捷方式，删除.venv目录，重新执行virtualenv .venv创建干净的虚拟环境，避免手动修改文件类型。

2. 修正PYTHONPATH的路径设置 #

将activate.ps1中添加的相对路径改为绝对路径，避免路径解析异常导致的Python调用错误：

$env:PYTHONPATH = "C:\Users\<USERNAME>\Documents\GitHub\Work\WPL_API\src\WPL-API;$env:PYTHONPATH"

修改完成后，关闭所有终端，重新打开VSCode并激活虚拟环境。

3. 验证终端环境变量 #

激活虚拟环境后，执行以下命令确认环境配置：

# 检查Python命令的指向
Get-Command python
# 检查PYTHONPATH设置
echo $env:PYTHONPATH

如果Get-Command返回的不是虚拟环境的python.exe，手动使用完整路径运行脚本测试：

.\.venv\Scripts\python.exe your_script.py

4. 调整VSCode的自动激活设置 #

打开VSCode设置，搜索python.terminal.activateEnvironment并取消勾选，然后手动在终端执行.venv\Scripts\activate.ps1激活虚拟环境，再运行脚本。

5. 强制调整终端PATH顺序 #

激活虚拟环境后，手动将虚拟环境Scripts目录放到PATH最前端：

$env:PATH = ".\.venv\Scripts;" + $env:PATH

之后再执行python命令运行脚本。

内容的提问来源于stack exchange，提问作者Please Ignore