Windows下用Cygwin64配置VS Code C调试环境提示无法启动调试如何解决

问题根源 #

Cygwin 版本的 GDB 默认使用 POSIX 风格路径规则，无法直接识别 Windows 原生带盘符、反斜杠的绝对路径，会将传入的 Windows 路径误判为相对于 GDB 默认工作目录 /usr/bin 的相对路径，最终出现路径前缀拼接错误、路径重复的问题，对应的错误码2就是系统找不到指定路径的可执行文件。

修复方案 #

需要同时修改 launch.json 和 tasks.json 两处配置，适配 Cygwin 的路径规则：

1. 调整 launch.json 配置

核心修改点：

• 路径统一使用正斜杠替代反斜杠，避免转义与路径识别冲突
• 修正环境变量引用语法，VS Code 中使用 ${env:PATH} 而非 CMD 风格的 %PATH%
• 新增 GDB 启动配置，禁用 shell 启动模式避免路径自动拼接
• 匹配自身 Cygwin 安装路径，不要混用盘符（你配置中 Cygwin 安装在C盘，PATH变量里不要写Z盘路径）

修改后完整配置参考：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "gcc.exe build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "${env:PATH};C:\\cygwin64\\bin"
                }
            ],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\cygwin64\\bin\\gdb.exe",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "Disable shell startup to fix Cygwin path splicing",
                    "text": "set startup-with-shell off",
                    "ignoreFailures": false
                }
            ],
            "logging": { "engineLogging": true },
            "preLaunchTask": "gcc.exe build active file"
        }
    ]
}

2. 调整 tasks.json 配置

核心修改点：

• 移除强制指定 Cygwin bin 为工作目录的配置，使用默认工作目录即可
• 编译参数路径统一使用正斜杠

修改后完整配置参考：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "gcc.exe build active file",
            "command": "C:\\cygwin64\\bin\\gcc.exe",
            "args": [
                "-g",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-Werror",
                "-Wall",
                "-Wextra",
                "-ansi",
                "-pedantic",
                "${file}"
            ],
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

验证步骤 #

修改完成后重启 VS Code，重新编译源文件后启动调试，即可正常识别可执行文件路径，不会再出现拼接错误。如果仍有问题，可以手动将 program 字段替换为 Cygwin 格式的绝对路径测试，你的测试文件对应路径为 /cygwin/e/cloud/Backup/Trabalhos com programas/C and Cpp/scripts/dirigir.exe。

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