VSCode远程调试Makefile编译C程序：断点无法触发求助

问题场景 #

通过VSCode的Remote-SSH扩展连接SUSE Linux服务器，已安装GDB Debugger -Beyond插件，服务器GDB版本12.1。程序通过Makefile编译，目录结构如下：

• 源码目录：/users/folder/13.1.0.src/
• Makefile位置：/users/folder/install/mqtt/
• 可执行文件目录：/users/folder/bin/
  编译前需加载3bs文件设置环境变量。已配置launch.json和tasks.json，编译正常且程序可运行，但printf行的断点无法触发。

原因分析 #

1. 可执行文件被移除调试符号 #

从make输出的最后一行可见执行了strip /users/folder/bin//test_debugger命令：

strip /users/folder/bin//test_debugger

strip工具会彻底移除可执行文件中的调试符号（DWARF信息），GDB依赖这些符号关联源码与二进制指令，缺失符号直接导致断点无法触发。

2. 部分目标文件未生成调试信息 #

观察编译输出，仅test_debugger.o的编译命令带有-g参数，其他目标文件（如client_shared.o、client_props.o）的编译过程未包含-g，这会导致部分代码段缺失调试符号，影响断点识别。

3. 源码路径映射可能存在偏差 #

VSCode远程调试时，若GDB无法自动匹配服务器源码路径与本地VSCode工作区路径，也会出现断点无法关联的情况。

解决方法（无需修改目录结构） #

1. 禁用Makefile中的strip操作 #

编辑/users/folder/install/mqtt/Makefile，注释或删除链接阶段的strip命令：
原链接规则：

$(DEST)/test_debugger : test_debugger.o client_shared.o client_props.o cJSON.o $(ISHARED) $(LIBGER_C)/libg-c.a
    $(CC) $(ANSI_FLAGS) $(CFLAGS) \
    test_debugger.o client_shared.o client_props.o cJSON.o \
    $(LIBGER_C)/libg-c.a $(MOSQUITTOLIB) -lcrypto -lpthread -lssl  $(TMP_REEL_I)/messq.o \
    -o $(DEST)/test_debugger ; \
    $(STRIP) $(DEST)/test_debugger

修改后：

$(DEST)/test_debugger : test_debugger.o client_shared.o client_props.o cJSON.o $(ISHARED) $(LIBGER_C)/libg-c.a
    $(CC) $(ANSI_FLAGS) $(CFLAGS) \
    test_debugger.o client_shared.o client_props.o cJSON.o \
    $(LIBGER_C)/libg-c.a $(MOSQUITTOLIB) -lcrypto -lpthread -lssl  $(TMP_REEL_I)/messq.o \
    -o $(DEST)/test_debugger
    # $(STRIP) $(DEST)/test_debugger

若需保留发布版本的strip操作，可添加环境变量控制：

$(DEST)/test_debugger : test_debugger.o client_shared.o client_props.o cJSON.o $(ISHARED) $(LIBGER_C)/libg-c.a
    $(CC) $(ANSI_FLAGS) $(CFLAGS) \
    test_debugger.o client_shared.o client_props.o cJSON.o \
    $(LIBGER_C)/libg-c.a $(MOSQUITTOLIB) -lcrypto -lpthread -lssl  $(TMP_REEL_I)/messq.o \
    -o $(DEST)/test_debugger
    ifndef DEBUG
        $(STRIP) $(DEST)/test_debugger
    endif

编译调试版本时执行：DEBUG=1 make $DEST/test_debugger

2. 确保所有编译目标都包含调试参数 #

修改Makefile，将-g添加到全局CFLAGS中，确保所有.o文件编译时生成调试符号：

CFLAGS += -g

重新编译后检查输出，确保所有gcc命令都包含-g参数。

3. 配置launch.json的源码路径映射 #

若GDB无法自动关联路径，在launch.json中添加sourceFileMap配置，映射服务器与本地工作区的源码路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "by-gdb",
            "request": "launch",
            "name": "Test",
            "program": "/users/folder/bin/test_debugger",
            "cwd": "${workspaceRoot}",
            "preLaunchTask": "run the makefile",
            "sourceFileMap": {
                "/users/folder/13.1.0.src/": "${workspaceFolder}/13.1.0.src/"
            }
        }
    ]
}

4. 验证调试符号 #

编译完成后，用GDB检查可执行文件是否包含调试符号：

gdb -q /users/folder/bin/test_debugger
(gdb) info sources

若能列出test_debugger.c等源码文件，说明符号正常；若提示"No sources."，需重新检查编译与strip步骤。

内容的提问来源于stack exchange，提问作者PépéMax