VSCode调试C代码时在printf处中断报错，如何解决？

问题重现 #

使用以下C代码：

#include <stdio.h>
int main() {
    int fahr, celsius;
    int inf, sup, incr;
    inf = 0;
    sup = 300;
    incr = 20;
    celsius = inf;
    while (celsius <= sup){
        printf("%d\t%d\n", celsius, fahr);
        celsius = celsius + incr;
    }
    return 0;
}

代码可正常运行，但调试时触发错误：

Could not load source './stdio-common/./stdio-common/printf.c': 'SourceRequest' not supported..

程序直接停止，无法单步执行。修改后的launch.json配置如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "(gdb) Launch",
      "type": "cppdbg",
      "request": "launch",
      "program": "enter program name, for example ${workspaceFolder}/a.out",
      "args": [
        "compile as g++ -g file.cpp -o file.o"
        
      ],
      "stopAtEntry": false,
      "cwd": "${fileDirname}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "gdb",
      "setupCommands": [
          {
              "description": "Enable pretty-printing for gdb",
              "text": "-enable-pretty-printing",
              "ignoreFailures": true
          },
          {
              "description": "Set Disassembly Flavor to Intel",
              "text": "-gdb-set disassembly-flavor intel",
              "ignoreFailures": true
          }
        
      ]
      
    },
    
    {
      "sourceFileMap": {"./../../src/": "~/pemCode/angle/src/"},
      "name": "C/C++ Runner: Debug Session",
      "type": "cppdbg",
      "request": "launch",
      "args": [],
      "stopAtEntry": false,
      "externalConsole": false,
      "cwd": "/home/fabio/Documents",
      "program": "/home/fabio/Documents/build/Debug/outDebug",
      "MIMode": "gdb",
      "miDebuggerPath": "gdb",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    }
  ]
}

解决步骤 #

1. 修复launch.json的基础配置错误 #

• 替换占位符程序路径：第一个配置项(gdb) Launch中的program字段是占位文本，需替换为你实际编译生成的可执行文件路径，例如${workspaceFolder}/a.out。
• 清理错误的args配置：args字段是程序运行时的参数，不是编译命令，需清空为[]。编译命令需单独执行（或通过tasks.json配置），必须带-g参数生成调试信息。
• 移除无关配置：第二个配置C/C++ Runner: Debug Session中的sourceFileMap是针对其他项目的路径映射，与当前问题无关，直接删除该配置项避免冲突。

2. 阻止调试器进入标准库函数 #

错误核心是调试器试图加载标准库（如printf）的源码，但你的环境未安装标准库调试源码，或路径映射错误。通过配置跳过标准库文件解决：
在launch.json的setupCommands中添加以下指令：

{
    "description": "Skip standard library source files",
    "text": "set skip-file-regex ^/usr/include/.*",
    "ignoreFailures": true
}

该指令会让gdb跳过所有系统头文件路径下的源码，避免尝试加载不存在的标准库调试文件。

3. 确保编译时生成调试信息 #

编译代码必须添加-g参数，否则调试器无法识别断点和变量：

gcc -g your_filename.c -o a.out

4. 最终正确的launch.json示例 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/a.out",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "Skip standard library source files",
                    "text": "set skip-file-regex ^/usr/include/.*",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

额外提示 #

你的C代码中fahr变量未初始化，打印输出为随机值，可补充初始化逻辑（如fahr = celsius * 9 / 5 + 32;）完善功能。

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