VS Code中Makefile Tools调试C项目报错：path参数需为字符串

云原生阿岚

2026-8-10

解决VS Code Makefile Tools调试时"The 'path' argument must be of type string. Received undefined"报错

检查launch.json的程序路径配置
打开.vscode/launch.json，确认program字段指向编译后的可执行文件绝对路径，或通过Makefile变量动态获取。示例配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C/C++: Makefile",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/bin/your-executable", // 保证路径有效且为字符串
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "Makefile: build"
        }
    ]
}

若使用Makefile变量，需在settings.json中配置"makefile.configurations": [{ "programPath": "bin/your-executable" }]，再在launch.json中用"program": "${command:makefile.launchTargetPath}"。

验证Makefile的输出路径配置
打开Makefile，确认编译目标的输出路径为明确字符串，无未定义变量。示例Makefile：
```
CC = gcc
CFLAGS = -g -Wall
OUT_DIR = bin
TARGET = $(OUT_DIR)/your-executable

all: $(TARGET)

$(TARGET): main.c
    mkdir -p $(OUT_DIR)
    $(CC) $(CFLAGS) -o $(TARGET) main.c
```
执行make后，检查$(OUT_DIR)下是否生成了可执行文件，确保TARGET变量不会解析为空。
重置Makefile Tools缓存
按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Makefile: Clean Configuration Cache执行，随后重新加载窗口（Ctrl+Shift+P -> Reload Window），再尝试调试。
检查系统PATH环境变量
确保PATH中包含gcc、gdb等工具的有效路径，无空值项。可在终端执行which gcc和which gdb验证工具是否可正常访问。