使用环境变量配置 VS Code Python 调试路径-Python教程-PHP中文网

使用环境变量配置 VS Code Python 调试路径

霞舞

发布： 2025-10-23 08:36:19

原创

404人浏览过

使用环境变量配置 vs code python 调试路径

本文介绍如何在 VS Code 的 launch.json 配置文件中使用环境变量来指定 Python 解释器路径，从而解决在不同机器上虚拟环境路径不同的问题。通过在 settings.json 中设置 python.defaultInterpreterPath，可以绕过 launch.json 中直接使用环境变量的限制，实现跨平台调试。

在 VS Code 中进行 Python 开发时，经常需要配置调试环境。当项目使用虚拟环境时，每个开发者的虚拟环境路径可能不同。为了避免在不同机器上修改 launch.json 文件，可以使用环境变量来动态指定 Python 解释器的路径。

然而，直接在 launch.json 文件的 "python" 字段中使用 ${env:YOUR_ENV_VARIABLE}/bin/python 这样的语法，在某些 VS Code 版本（例如 1.85）中可能无法正常工作，导致调试配置失效。

解决方案：使用 settings.json 配置 Python 解释器路径

立即学习“Python免费学习笔记（深入）”；

一个有效的解决方案是将 Python 解释器的路径配置在 settings.json 文件中，而不是直接在 launch.json 中配置。

移除 launch.json 中的 "python" 字段:

首先，从你的 launch.json 文件中移除 "python" 字段。例如，你的 launch.json 文件可能如下所示：
```
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Django",
      "type": "python",
      "request": "launch",
      "program": "${workspaceFolder}/src/manage.py",
      "args": [
        "runserver",
      ],
      "django": true
    }
  ]
}
```
登录后复制
注意，"python": "${env:PROJ_VENV}/bin/python" 这一行已经被移除。

白瓜面试
白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情
在 settings.json 中设置 python.defaultInterpreterPath:

打开你的 settings.json 文件（可以通过 VS Code 的 "Preferences: Open Settings (JSON)" 命令打开），添加或修改 "python.defaultInterpreterPath" 字段，并将其设置为包含环境变量的 Python 解释器路径。
```
{
  "python.defaultInterpreterPath": "${env:PROJ_VENV}/bin/python"
}
```
登录后复制
确保你的环境变量 PROJ_VENV 已经正确设置。例如，在你的 .zshrc 或 .bashrc 文件中：
```
export PROJ_VENV=$HOME/.cache/pypoetry/virtualenvs/myproj-NMmw6p6o-py3.12
```
登录后复制
请根据你的实际虚拟环境路径修改 PROJ_VENV 的值。
选择 "Use Python from python.defaultInterpreterPath" 作为 Python 解释器:

在 VS Code 中，打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 "Python: Select Interpreter"，然后选择 "Use Python from python.defaultInterpreterPath"。如果VS Code正确读取了环境变量，你应该能看到对应的Python解释器。

总结

通过将 Python 解释器路径配置在 settings.json 中，可以有效地利用环境变量，实现跨平台的调试配置，避免了在不同机器上修改 launch.json 文件的麻烦。这种方法在 VS Code 版本 1.85 及更高版本中尤其有效，可以作为一种通用的解决方案。记住，要确保你的环境变量已经正确设置，并且 VS Code 能够正确读取这些环境变量。

以上就是使用环境变量配置 VS Code Python 调试路径的详细内容，更多请关注php中文网其它相关文章！