VSCode调试Go程序断点不生效，启动时提示“Could not find file”问题求助

问题核心特征 #

调试启动后断点变为空心，悬浮提示Could not find file ...，程序运行正常但未命中任何断点。

可能原因及修复方案 #

• 多模块项目路径映射错误
  你使用的Go 1.17版本对多模块项目的支持需要额外配置，未正确配置时Go扩展和delve无法识别子模块的源文件路径：
  1. 可升级到Go 1.18+正式版本，使用原生多模块工作区：在项目根目录执行go work init，再执行go work use ./子模块1目录 ./子模块2目录添加所有子模块
  2. 若保持Go 1.17版本，可在根目录go.mod中用replace指令将子模块路径指向本地相对路径，或者配置VSCode设置go.workspaceUse自动识别子模块
• launch.json配置路径不匹配
  默认生成的launch配置可能和项目结构不匹配，重点检查两个参数：
  1. program：必须指向main包所在的目录，若main.go存放在cmd/xxx下，可配置为"program": "${workspaceFolder}/cmd/xxx"
  2. 移除buildFlags中的-trimpath参数：该参数会删除编译产物中的源文件绝对路径，导致delve无法匹配源码
• 编译开启了优化/内联
  编译器优化会丢失调试信息，在launch.json中添加参数强制禁用优化：

  "buildFlags": "-gcflags=\"all=-N -l\""
  

• 路径大小写/软链接不匹配
  Ubuntu系统大小写敏感，若存在以下情况会导致路径匹配失败：
  1. 源码路径、go.mod模块名、工作区路径存在大小写不一致
  2. 用软链接路径打开项目工作区，delve识别的物理路径和软链接路径不匹配，直接打开项目的物理路径作为工作区即可修复
• 调试适配器兼容问题
  旧版本dlv对DAP协议的适配存在缺陷，可切换为传统调试适配器：在VSCode设置中搜索go.delveConfig.debugAdapter，修改值为legacy，重启调试即可。
• delve版本不匹配
  重新安装匹配当前Go版本的delve：执行命令go install github.com/go-delve/delve/cmd/dlv@v1.7.1，安装完成后重启调试。

内容的提问来源于stack exchange，提问作者David M. Karr