Ubuntu下VSCode搭配g++/gdb调试如何跳过非项目C++系统文件

一、VSCode原生调试配置（无需手动敲GDB命令，适配现有操作习惯） #

这是和图形化调试流程完全兼容的方案，不需要改动现有按键操作，通过VSCode C/C++扩展的内置规则透传给底层GDB，效果和手动执行skip命令完全一致：

• 在项目根目录的.vscode/launch.json调试配置块中，新增skipFiles字段，配置匹配规则：

  "skipFiles": [
      // 匹配所有C++标准库系统头文件路径
      "/usr/include/c++/**/*.h",
      "/usr/include/x86_64-linux-gnu/c++/**/*.h",
      "/usr/include/bits/**/*.h",
      // 匹配所有系统动态库文件
      "/usr/lib/x86_64-linux-gnu/**/*.so",
      // 规则优先级：仅允许跳转到当前工作区的项目代码
      "!${workspaceFolder}/**"
  ]
  

• 配置生效后，不管是按F10单步跳过还是F11单步进入，只要执行流匹配到上述规则的文件，GDB会自动跳过代码行，完全不会暂停在basic_string.h这类非项目文件中。
• 如果需要全局对所有项目生效，可以在VSCode的C/C++扩展全局设置中配置相同的skipFiles规则，不需要每个项目单独写。

二、GDB启动配置规则（全局生效，命令行调试也能复用） #

GDB启动时会自动加载规则配置文件，不管是VSCode拉起的GDB进程，还是终端手动启动的GDB，都会自动执行对应的跳过逻辑：

• 在用户主目录~下创建/编辑.gdbinit配置文件，写入跳过规则：

  # 跳过所有C++标准库的系统头文件
  skip file /usr/include/c++/*
  skip file /usr/include/x86_64-linux-gnu/c++/*
  skip file /usr/include/bits/*
  # 跳过所有std命名空间下的内部实现函数
  skip function std::*
  # 开启静默跳过，跳过过程不打印冗余日志
  set skip silent on
  

• 若VSCode默认启动GDB时没有加载该配置，可以在launch.json中新增setupCommands字段，强制让GDB启动时读取规则：

  "setupCommands": [
      {
          "text": "source ~/.gdbinit",
          "ignoreFailures": true
      }
  ]
  

三、编译环节配置（从调试信息源头减少系统文件打断） #

当前使用的编译参数是全量调试信息级别（-g），会将系统头文件的行号调试信息也加载到可执行文件的调试段中，这是步进进入系统文件的核心原因之一，可以通过调整编译参数解决：

• 将原有编译命令中的-g全量调试参数，替换为仅针对项目代码生成调试信息的级别，对应Makefile修改：

  # 原参数 -g 替换为 -g1
  g++ -fno-common -fPIC -fno-strict-aliasing -fexceptions -fopenmp -c -g1 -std=c++14 -MMD -MP -MF "build/Debug/GNU-Linux/_ext/1/Main.o.d" -o build/Debug/GNU-Linux/_ext/1/Main.o ../src/Main.cpp
  

• 参数说明：-g1级别仅会生成当前项目代码的最小调试信息，不会将系统头文件、动态库的行号信息写入调试段，从根本上减少步进跳转非项目文件的概率。如果需要保留更完整的项目调试信息，可以额外增加编译参数-fdebug-prefix-map=/usr/include/=，将系统路径的调试信息映射为空路径，GDB加载时无法匹配到系统文件路径，自然不会触发文件内的暂停。

补充说明：单靠编译参数调整无法完全规避系统动态库带调试符号带来的跳转问题，建议搭配前述的GDB跳过规则，形成完整的拦截逻辑。

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