直接在 settings.json 中配置 Python 虚拟环境路径是可行的，但更推荐先通过命令面板选择，手动修改适合作为自动化部署或特殊场景的补充手段。

命令速用版

如果你确定要手动编辑配置文件，请在 settings.json 中添加以下键值对。注意 key 名称已更新，旧版配置项已不再推荐。

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

Windows 用户请注意路径分隔符，建议使用正斜杠或双反斜杠：

{
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe"
}

为什么会这样

VSCode 的 Python 扩展在启动时会扫描工作区下的常见虚拟环境目录（如 .venv、venv、.conda 等）。自动发现机制虽然方便，但在多环境切换或路径不规范时可能选错。settings.json 中的配置属于用户或工作区设置，其优先级高于自动探测结果。通过显式指定路径，可以确保编辑器始终使用预期的 Python 解释器，避免依赖包版本混乱。

分步处理

1. 获取虚拟环境路径

先在终端激活你的虚拟环境，然后运行以下命令获取绝对路径：

python -c "import sys; print(sys.executable)"

复制输出的完整路径。如果是工作区内的虚拟环境，也可以记录相对路径，如 .venv/bin/python。

2. 打开 settings.json

在 VSCode 中按下 Ctrl+Shift+P（Mac 为 Cmd+Shift+P），输入 Preferences: Open Workspace Settings (JSON)。建议优先使用工作区设置，这样配置会随项目提交，不影响其他项目。

3. 写入配置

将第一步获取的路径填入 python.defaultInterpreterPath 字段。如果文件为空，请确保包裹在大括号 {} 中。

4. 保存并重载

保存文件后，VSCode 通常会自动 reload 窗口。如果没有变化，可手动执行 Developer: Reload Window 命令。

怎么验证是否生效

1. 检查状态栏

查看 VSCode 窗口左下角，Python 版本号旁边应显示你配置的解释器路径或环境名称。点击该区域可以再次确认当前选中的路径是否与配置一致。

2. 终端验证

在 VSCode 内置终端中运行：

import sys
print(sys.executable)


输出路径应与 settings.json 中配置的路径完全一致。
3. 调试配置
尝试运行一个断点调试会话，查看调试控制台中的解释器路径，确保调试器也使用了同一环境。
常见坑
1. 使用了废弃的配置项
早期文档中常见的 python.pythonPath 已被标记为废弃。虽然部分旧版本插件仍支持，但新项目中应使用 python.defaultInterpreterPath，否则可能导致配置不生效或收到警告。
2. Windows 路径斜杠问题
Windows 系统默认使用反斜杠 \，但在 JSON 文件中反斜杠是转义字符。建议统一使用正斜杠 /，VSCode 在 Windows 上也能正确识别，或者使用双反斜杠 \\。
3. 相对路径基准
如果使用相对路径，基准目录是工作区根目录。建议配合 ${workspaceFolder} 变量使用，避免直接写相对路径导致在不同操作系统或打开方式下解析错误。
参考来源
Microsoft Learn, "Python environments in Visual Studio Code", https://code.visualstudio.com/docs/python/environments
Microsoft VSCode Python Extension Settings, "python.defaultInterpreterPath", https://github.com/microsoft/vscode-python/wiki/Settings