如何让VSCode的解释器列表中显示我的Python venv虚拟环境？

1. 校验venv目录权限与可执行性 #

• 打开终端，进入项目根目录，执行权限修复命令：chmod -R 755 ./venv
• 执行./venv/bin/python --version，确认能正常输出版本号无报错。如果执行失败，说明虚拟环境本身创建异常，可删除后重建：rm -rf venv && python3 -m venv venv

2. 写入工作区固定配置 #

• 在VSCode中打开目标项目，按下Command + Shift + P调出命令面板，搜索「打开工作区设置(JSON)」并进入
• 在配置文件中添加如下内容，保存后关闭：

{
    "python.pythonPath": "${workspaceFolder}/venv/bin/python"
}

3. 刷新解释器缓存 #

• 再次按下Command + Shift + P，搜索「Python: 刷新解释器列表」并执行
• 完全退出VSCode后重新打开项目，此时「选择解释器」列表会正常显示venv环境，配置不会再自动回退

兼容问题排查 #

如果操作后仍不生效，需检查Python插件版本：VSCode 1.54.3最高适配v2021.3.68075109版本的Python插件，更高版本插件会出现配置兼容问题，降级到对应版本即可解决。

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