VSCode跨文件夹调试Python：如何启用‘Debug Python file’按钮？

当VSCode工作目录与Python脚本所在目录不一致时，"Debug Python file"按钮失效但"Run Python file"能正常运行，核心原因是两者的工作目录处理逻辑不同：

• "Run Python file"会自动将工作目录切换至脚本所在文件夹
• "Debug Python file"默认使用VSCode的根目录作为工作目录，未设置cwd参数导致调试环境异常

要让"Debug Python file"按钮正常工作，可通过以下两种方式解决：

方法一：修改默认调试配置模板 #

通过VSCode全局设置，让所有"Debug Python file"启动的调试自动应用cwd配置：

1. 打开VSCode设置（快捷键Ctrl+,）
2. 搜索python.debugging.launchConfigurations
3. 添加如下配置：

   "python.debugging.launchConfigurations": [
       {
           "type": "python",
           "request": "launch",
           "name": "Python: Current File",
           "program": "${file}",
           "cwd": "${fileDirname}"
       }
   ]
   

   保存设置后，再点击"Debug Python file"按钮，调试器会自动将工作目录切换至当前脚本所在文件夹，与"Run Python file"行为一致。

方法二：将自定义配置设为默认 #

如果你已经在launch.json中添加了有效的调试配置，可将其设为默认，让"Debug Python file"优先使用该配置：

1. 打开.vscode/launch.json文件
2. 将你的配置的name修改为默认的"Python: Current File"（与插件默认配置名称一致），或者保持原有名称，在调试面板的配置下拉菜单中右键点击该配置，选择"Set as Default Configuration"

这样，点击"Debug Python file"时会直接调用你配置好的带cwd参数的调试规则，解决跨目录调试问题。

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