Windows 11系统中VS Code内Python虚拟环境(venv)激活异常问题咨询

这种情况我之前在Windows环境下折腾虚拟环境时也碰到过，结合你提到的Azure Functions项目背景，咱们来拆解问题根源和解决思路：

一、核心问题：py命令的特殊优先级逻辑 #

Windows自带的py.exe（Python启动器）有一套独立的版本选择规则，完全绕开了虚拟环境的PATH配置：

• 虚拟环境激活后，只是把自身的python.exe加到了终端PATH的最前面，但py命令根本不看这个——它会优先读取注册表、py.ini配置或者PY_PYTHON环境变量来选择全局Python版本。
• 你看到终端显示(.venv)前缀、VS Code右下角选中了venv解释器，其实只是VS Code的UI层面识别了虚拟环境，但终端里的py命令依然指向全局Python。这也解释了为什么py -c "import sys; print(sys.prefix == sys.base_prefix)"返回True——你执行的是全局Python，自然没进入虚拟环境。

二、Azure Functions项目的额外干扰 #

Azure Functions的VS Code插件会对终端环境做额外配置：

• 插件可能会自动注入函数运行相关的环境变量，或者在启动终端时加载专属脚本，这可能会干扰虚拟环境激活脚本（Activate.ps1）的PATH修改逻辑，导致虚拟环境的Python路径被全局路径覆盖。

三、具体解决步骤 #

1. 替换py为python命令 #

虚拟环境激活后，直接用python代替py执行命令，因为python会优先遵循终端PATH的优先级（虚拟环境路径在前）：

# 安装nodeenv到虚拟环境
python -m pip install nodeenv

# 验证当前Python路径（应该返回venv内的python.exe）
Get-Command python

# 重新检测虚拟环境激活状态
python -c "import sys; print(sys.prefix == sys.base_prefix)"

正常激活后，这条检测命令应该返回False。

2. 手动触发虚拟环境激活脚本 #

有时候VS Code的终端可能没有正确执行激活脚本，你可以手动在终端里运行：

.\.venv\Scripts\Activate.ps1

执行后再用上面的命令验证环境是否生效。

3. 确认VS Code的Python配置 #

检查项目根目录下的.vscode/settings.json，确保以下配置正确指向虚拟环境：

{
    "python.pythonPath": "${workspaceFolder}\\.venv\\Scripts\\python.exe",
    "terminal.integrated.defaultProfile.windows": "PowerShell"
}

配置完成后关闭所有终端窗口，重新打开VS Code终端，让环境重新加载。

4. 适配Azure Functions插件配置 #

针对Azure Functions项目，还需要确保插件也使用虚拟环境的Python：

• 打开命令面板（Ctrl+Shift+P），输入Azure Functions: Configure Local Python Interpreter，选择你的.venv/Scripts/python.exe。
• 这样插件在运行本地函数时，也会使用虚拟环境的依赖，避免和全局环境冲突。

内容的提问来源于stack exchange，提问作者Stephan Ducrepin