Delve调试需确保dlv在PATH中、编译未strip调试信息；PATH配置错误是安装失败主因，macOS/Linux需source shell配置并重启VS Code，Windows需设系统环境变量且避免Git Bash启动；VS Code断点失效多因mode/program配置错或ldflags去除了符号表。
Delve 不需要“教程式安装”，只要 go install 成功、dlv 在 PATH 中、编译不 strip 调试信息，断点和单步就能立刻用起来。
go install 安装 dlv 命令失败或找不到
根本原因几乎全是 PATH 没生效，不是 Delve 本身的问题：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest后，dlv默认落在$GOPATH/bin（Go $GOROOT/bin（Go ≥ 1.21），不是/usr/local/bin - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否追加了export PATH="$GOPATH/bin:$PATH"；改完必须source ~/.zshrc，且 VS Code 要**完全重启**（只 reload window 不行） - Windows：确认系统环境变量中已添加
%GOPATH%\bin，且不要用 Git Bash 启动 VS Code —— 它的 PATH 和系统不一致 - 验证方式：在终端直接运行
which dlv（macOS/Linux）或where dlv（Windows），再执行dlv version看是否输出版本号
VS Code 断点不命中或提示 “dlv not found”
VS Code 的 Go 扩展会自动检测 dlv，但依赖两个关键配置项匹配：
-
"mode"必须与项目结构对齐："auto"（推荐）、"debug"（单文件）、"test"（跑测试）、"exec"（调试已编译二进制）；若main.go不在根目录，"program"得写成"./cmd/myapp"，不能留空或写错路径 - 插件设置里搜
go.delvePath，手动填入dlv的绝对路径（比如/Users/xxx/go/bin/dlv），比依赖 PATH 更可靠 - 断点不命中常见于编译时加了
-ldflags="-s -w"—— 这会剥离符号表和调试信息，Delve 无法映射源码行；开发阶段务必禁用 - 确保 Go 文件已保存，Delve 启动前会先
go build，未保存的语法错误会导致构建失败、调试直接退出
命令行调试时常用命令记不住
不需要背全，日常够用就这五个：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
b main.main—— 在程序入口设断点（最稳的起点） -
b utils.go:42—— 在指定文件第 42 行设断点（注意文件名要带.go） -
c—— 继续运行到下一个断点 -
n—— 下一行（不进函数）；s—— 步入函数内部（比如想看json.Unmarshal里发生了什么） -
p err—— 打印变量err的值；p &v可看地址，pp v（pretty print）更适合结构体或 slice
其他命令如 goroutines、stack、regs 按需查 help 即可，不必强记。
macOS / Linux 权限报错：“not authorized to debug” 或 “ptrace_scope”
这不是 Delve 的 bug，是系统安全策略拦截：
- macOS：打开「系统设置 → 隐私与安全性 → 完全磁盘访问」，把你的终端（iTerm / Terminal / VS Code）拖进去，**重启终端**才生效
- Linux（尤其是 Ubuntu/Debian）：临时放开调试权限，运行
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope；如需永久生效，往/etc/sysctl.d/10-ptrace.conf写入kernel.yama.ptrace_scope = 0 - 这两类报错都发生在
dlv debug或dlv attach阶段，跟代码逻辑无关，别浪费时间查 Go 源码
真正容易被忽略的是：Delve 调试能力高度依赖编译产物的完整性。哪怕 dlv version 正常、launch.json 配对、PATH 全通，只要用了 -ldflags="-s -w" 或交叉编译时没保留调试符号，断点就注定失效 —— 这个限制不会报错，只会静默跳过。
