本文档旨在解决在 VS Code 中，当 Python 虚拟环境路径因机器而异时，如何通过环境变量配置 launch.json 文件，以便在不同机器上复用同一份配置。本文将提供一种有效的替代方案，通过修改 settings.json 来实现 Python 解释器的动态配置。
在 VS Code 中调试 Python 项目时，通常需要在 launch.json 文件中指定 Python 解释器的路径。然而，当使用 Poetry 等工具创建虚拟环境时，不同机器上虚拟环境的路径可能包含随机生成的哈希值，导致 launch.json 文件在不同机器上无法直接通用。直接在 launch.json 中使用 ${env:VAR_NAME} 引用环境变量的方式，在某些 VS Code 版本中可能无法正常工作。
解决方案：使用 settings.json 配置 Python 解释器路径
一种有效的替代方案是，不在 launch.json 中直接指定 "python" 路径，而是通过修改 settings.json 文件来设置默认的 Python 解释器路径。
立即学习“Python免费学习笔记（深入）”；
-
修改 settings.json：
在项目的 .vscode 目录下，找到或创建 settings.json 文件。添加或修改 "python.defaultInterpreterPath" 配置项，将其值设置为包含环境变量的路径：
{ "python.defaultInterpreterPath": "${env:PROJ_VENV}/bin/python" }这里的 PROJ_VENV 是你已经在系统环境变量中定义的虚拟环境路径。 确保该环境变量在你的 shell 配置文件（例如 .zshrc 或 .bashrc）中正确设置。
-
验证 Python 解释器选择：
重启 VS Code 或重新加载窗口。 然后，通过 VS Code 的 Python 扩展选择 Python 解释器。 选择 "Use Python from python.defaultInterpreterPath" 选项。 如果一切配置正确，VS Code 将使用 settings.json 中指定的环境变量所指向的 Python 解释器。
示例：
假设你的 .zshrc 文件中定义了以下环境变量：
export PROJ_VENV=$HOME/.cache/pypoetry/virtualenvs/myproj-NMmw6p6o-py3.12
并且你的 settings.json 文件内容如下：
{
"python.defaultInterpreterPath": "${env:PROJ_VENV}/bin/python"
}那么，VS Code 将使用 $HOME/.cache/pypoetry/virtualenvs/myproj-NMmw6p6o-py3.12/bin/python 作为默认的 Python 解释器。
注意事项：
- 确保环境变量在 VS Code 启动前已经正确设置。 你可以通过在终端中运行 echo $PROJ_VENV 来验证环境变量是否生效。
- 如果修改了环境变量，需要重启 VS Code 或重新加载窗口，以使更改生效。
- 这种方法适用于大多数 Python 项目，尤其是在使用虚拟环境的情况下。
- 如果需要在不同的调试配置中使用不同的 Python 解释器，仍然可以在 launch.json 中覆盖 python.defaultInterpreterPath 的设置，但通常情况下，使用全局的 python.defaultInterpreterPath 更为方便。
总结：
通过将 Python 解释器路径配置在 settings.json 中，并使用环境变量动态指定路径，可以有效解决在不同机器上复用 launch.json 文件的问题。这种方法不仅简化了配置过程，还提高了项目的可移植性。 避免直接在 launch.json 的 "python" 字段中使用 ${env:VAR_NAME}，而是使用 settings.json 中的 "python.defaultInterpreterPath"，能够更可靠地工作。
