使用环境变量配置 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 中配置。

1. 移除 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" 这一行已经被移除。

   

   ImgGood

   免费在线AI照片编辑器

   下载

2. 在 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 的值。

3. 选择 "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 能够正确读取这些环境变量。