Go远程调试必须使用dlv，安装需用go install并验证权限与符号支持，macOS/WSL需特殊配置；远程调试须用dlv serve启动服务端，VS Code需用attach模式连接；构建时禁用优化（-N -l）以保留调试符号，且dlv与目标程序平台必须严格匹配。
Go 本身不内置远程调试服务器，必须依赖 dlv（Delve）——这是唯一被广泛支持、能稳定跨平台（Linux/macOS/Windows）且兼容 Go 1.16+ 的调试器。直接用 go run 或 IDE 自带的“调试”按钮，底层几乎都调用了 dlv。
安装并验证 dlv 是否真正可用
很多问题出在 dlv 安装后未正确编译或权限不足，尤其在 macOS 和 Windows WSL 上：
- 用
go install github.com/go-delve/delve/cmd/dlv@latest安装（不要用brew install delve，它常滞后且 macOS 上可能缺少符号调试支持） - 安装后立刻运行
dlv version，确认输出含Build ID且无permission denied或cannot find symbol table - macOS 用户必须手动允许全盘访问权限：系统设置 → 隐私与安全性 → 全盘访问 → 勾选终端或你的 IDE（如 VS Code）
- Windows 用户若用 WSL2，
dlv必须在 WSL 内安装并运行，不能从 Windows 侧调用；原生 Windows 版需确保CGO_ENABLED=1且已安装 MinGW 工具链
启动 dlv serve 进行真正的远程调试
dlv debug 只适用于本地单步，远程调试必须用 dlv serve 启动一个调试服务端，再由 IDE 或另一台机器连接：
- 调试本机其他进程（比如已部署的服务）：
dlv attach <pid> --headless --api-version=2 --accept-multiclient --continue</pid> - 调试新启动的程序（推荐）：
dlv exec ./myapp --headless --api-version=2 --addr=:2345 --accept-multiclient --continue -
--headless是必须的，表示无 UI；--api-version=2是当前 VS Code、GoLand 等 IDE 唯一兼容的协议版本；--accept-multiclient允许多个客户端（如多个 IDE 实例或 CLIdlv connect）同时接入 - 如果服务要暴露给局域网其他机器，把
--addr=:2345改成--addr=0.0.0.0:2345，但务必加防火墙限制，dlv默认无认证
VS Code 中配置 launch.json 连接远程 dlv
不是所有 launch.json 配置都能连上远程 dlv，关键在于 mode 和 port 的匹配：
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
立即学习“go语言免费学习笔记（深入）”；
- 当
dlv serve在远程 Linux 机器上运行（如dlv exec ./app --headless --addr=:2345），本地 VS Code 应使用mode: "attach"而非"debug" - 必须显式指定
port和host，不能省略host（即使连本机也要写"localhost"） - 示例有效配置：
{
"version": "0.2.0",
"configurations": [
{
"name": "Connect to remote dlv",
"type": "go",
"request": "attach",
"mode": "exec",
"port": 2345,
"host": "192.168.1.100",
"program": "/home/user/myapp"
}
]
}
注意：program 字段填的是远程机器上的二进制绝对路径，不是本地路径；VS Code 不会上传文件，它只发调试指令。
调试时变量无法展开或断点不命中？检查构建方式
Go 编译默认开启优化（-ldflags="-s -w"），这会剥离调试符号，导致 dlv 无法读取变量、跳转错乱：
- 远程调试前，务必用
go build -gcflags="all=-N -l" -o myapp .构建，其中-N禁用优化，-l禁用内联 - 如果程序是通过
go run启动的，它默认也加了优化，等价于go build -ldflags="-s -w"，所以dlv exec不能直接调试go run的临时二进制 - 交叉编译（如在 macOS 上编译 Linux 二进制）时，
dlv必须与目标平台一致：Linux 二进制只能用 Linux 版dlv调试，即使你用GOOS=linux go build生成了它
跨平台调试最易忽略的一点：调试器和被调程序的架构/OS 必须严格匹配，dlv 不做 ABI 适配，连 arm64 和 amd64 混用都会静默失败。
