根本原因是gdb找不到编译时记录的源文件路径，需确保编译时加-g、未strip，并用directory命令或-fdebug-prefix-map重映射路径，必要时通过readelf验证调试信息。
gdb 调试时显示 “No source file found” 怎么办
根本原因是 gdb 找不到编译时记录的源文件路径，或者源文件已被移动、删除，或编译时没带调试信息。不是代码写错了，而是路径或编译选项断了链。
-
gcc编译时必须加-g，否则gdb里连变量名都看不到，更别说源码行号 - 用
gdb a.out启动后，运行info sources查看 gdb 认为该找哪些文件；再用list看是否能显示第一行——失败就说明路径对不上 - 常见错误现象：gdb 提示
main.c: No such file or directory，但你确信 main.c 就在当前目录——其实是编译时记录的是绝对路径（比如/home/user/project/main.c），而你现在在别处打开了可执行文件 - 临时修复：用
directory /path/to/src告诉 gdb 去哪找源码，支持多个路径，用冒号分隔，比如directory ./src:/home/user/project - 一劳永逸：编译时用
-fdebug-prefix-map重写路径，例如gcc -g -fdebug-prefix-map=/home/user/project=.，这样调试时就按相对路径找，不依赖原始绝对路径
为什么加了 -g 还是看不到源码
加了 -g 只保证调试信息存在，不保证路径可用。很多构建流程（尤其是 make 或 CMake）会把源码和构建目录分开，导致调试信息里存的是构建机上的路径，而非你本地的。
- 检查调试信息是否真包含源路径：运行
readelf -p .debug_line a.out | head -20，看输出里有没有类似main.c的字符串；如果全是空或乱码，说明-g没生效或被后续 strip 掉了 - 确认没被 strip：
file a.out输出里若含stripped字样，说明符号和调试段已被删，得重新编译，别跑strip a.out - CMake 项目容易踩坑：默认
RelWithDebInfo模式可能不带完整路径映射，建议显式设set(CMAKE_CXX_FLAGS_DEBUG "-g -fdebug-prefix-map=${CMAKE_SOURCE_DIR}=.") - 跨机器调试（比如嵌入式）时，
gdb在目标机上运行，但源码只在开发机上——这时必须用directory或远程源码映射，不能指望自动发现
VSCode + gdb 调试找不到源文件的典型场景
VSCode 的 launch.json 里 miDebuggerPath 和 program 都对，但断点灰了、F11 进不去函数——大概率是源码路径没对齐，尤其在 Windows + WSL 或远程 SSH 场景下。
- Windows 上用 WSL 编译，但 VSCode 在 Windows 端打开项目：gdb 记录的是
/home/user/proj/main.c，而 VSCode 默认按 Windows 路径找C:\Users\...\main.c，必然失败 - 解决方法：在
launch.json的sourceFileMap字段做路径映射，例如：{ "sourceFileMap": { "/home/user/proj": "${workspaceFolder}" } } - SSH 远程调试时，
sourceFileMap必须指向远程机器上的真实路径，且 VSCode 的 Remote-SSH 插件要已连接成功；本地打开的文件只是镜像，gdb 实际读的是远程文件系统 - 别依赖 “自动定位”：VSCode 不会主动扫描整个磁盘找同名
main.c，它严格按调试信息里的路径 +sourceFileMap规则匹配
编译时路径处理不当的连锁反应
一个看似无关的编译选项，可能让调试体验彻底崩坏。最隐蔽的是构建目录结构和 -fdebug-prefix-map 的配合问题。
- 用
gcc -g -I./inc main.c -o main编译，没问题；但若改成mkdir build && cd build && gcc -g -I../inc ../main.c -o main，调试信息里记录的就是../main.c，回到项目根目录运行gdb ./build/main就会找不到源码 - 正确做法是：在 build 目录里编译时，加
-fdebug-prefix-map=$PWD/..=.，把上级目录映射成当前工作区根 - CI/CD 流水线里更危险：Docker 构建时工作目录是
/workspace，但调试包发给开发人员后，他们本地路径是/Users/me/project——没做路径重映射，gdb 就只能显示汇编 - 记住：调试信息里的路径是“编译发生地”的快照，不是“你希望它在哪”。控制权在编译命令，不在调试器
readelf -p .debug_line 看清调试信息里到底记了什么。
