如何配置VS Code自动识别自定义路径的工作区本地Python虚拟环境？

核心问题原因 #

你之前配置python.venvFolders没生效，大概率是配置位置选错了：如果在全局用户设置里用${workspaceFolder}，这个变量在全局环境下无法正确解析，VS Code会把它当成用户主目录下的普通文件夹名，自然找不到你的虚拟环境。

正确配置方法 #

1. 用工作区设置而非全局设置 #

打开当前项目的.vscode/settings.json（没有的话直接新建这个文件），在里面添加配置：

"python.venvFolders": [
  "venv/3.11",
  "venv/3.10",
  "venv/3.9"
]

工作区设置里的路径默认是相对于${workspaceFolder}的，不用额外写变量，直接写相对路径即可。

2. 更灵活的通配符写法 #

如果后续还要加其他版本的虚拟环境，不用逐个添加路径，直接用通配符匹配venv下所有子目录：

"python.venvFolders": ["venv/*"]

3. 让配置生效的步骤 #

配置完成后，按Ctrl+Shift+P调出命令面板，选择Reload Window重启VS Code工作区，之后点击右下角状态栏的Python版本号打开解释器选择列表，就能看到所有符合路径的虚拟环境了。

额外提示 #

• 确保你的VS Code Python插件是最新版本，旧版本对路径匹配的支持可能有问题。
• 如果还是没识别到，检查虚拟环境结构：每个版本目录下必须有bin（Linux/macOS）或Scripts（Windows）文件夹，里面要有python.exe（或python可执行文件）。

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