添加参数启动VSCode Python调试时文件路径异常问题

正常运行场景 #

Windows系统中VSCode将GitBash设为集成终端，默认配置下启动Python调试器可正常运行，终端执行命令如下：

/usr/bin/env c:\Users\augus\.Apps\anaconda3\envs\muskit-env\python.exe \
c:\Users\augus\.vscode\extensions\ms-python.debugpy-2024.2.0-win32-x64\bundled\libs\debugpy\adapter/../..\debugpy\launcher \
53684 -- E:\muskit\QuantumSoftwareTestingTools\Muskit\Muskit\CommandMain.py

此时文件路径使用双反斜杠，命令可正常执行。

添加args后的异常情况 #

在launch.json中添加args属性后出现错误，配置内容如下：

{
    "configurations": [
        {
            "name": "Python Debugger: Current File with Arguments",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "args": "foo"
        }
    ]
}

终端执行的命令变为：

$  /usr/bin/env c:\Users\augus\.Apps\anaconda3\envs\muskit-env\python.exe \
c:\Users\augus\.vscode\extensions\ms-python.debugpy-2024.2.0-win32-x64\bundled\libs\debugpy\adapter/../..\debugpy\launcher \
53805 -- E:\muskit\QuantumSoftwareTestingTools\Muskit\Muskit\CommandMain.py foo 

随即抛出错误：

/usr/bin/env: ‘c:Usersaugus.Appsanaconda3envsmuskit-envpython.exe’: No such file or directory

问题核心：添加args后，文件路径的双反斜杠被转成单反斜杠，导致路径解析失败。

分析与解决方法 #

这是debugpy在GitBash终端环境下处理路径转义的兼容性问题，并非配置遗漏。可尝试以下解决方案：

• 修正args格式：将"args": "foo"改为数组形式"args": ["foo"]，规范参数传递格式，减少转义异常。
• 指定Python解释器的GitBash路径：在launch.json中添加"python": "/c/Users/augus/.Apps/anaconda3/envs/muskit-env/python.exe"，使用正斜杠的WSL风格路径，避免转义问题。
• 临时切换终端类型：改用Windows默认的Command Prompt或PowerShell作为集成终端，验证调试是否正常，确认GitBash的兼容性影响。

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