远程调试Go前必须确认：一、远程装dlv且版本兼容Go（如Go1.21+需dlv≥v1.22.0），二、远程有完整go工具链并配置好GOPATH/GOROOT，三、launch.json中program用绝对路径、mode推荐exec、端口映射正确。
Go远程调试前必须确认的三件事
VSCode Remote SSH 调试 Go 程序不是连上就跑，缺一不可：远程服务器得装 dlv（Delve），本地 VSCode 得装 Go 和 Remote - SSH 插件，且 go 命令在远程 $PATH 里能直接调用。
-
dlv版本要和 Go 版本兼容——Go 1.21+ 推荐用dlv@master或至少v1.22.0+，旧版可能卡在exec: "gcc": executable file not found - 远程不能只装
dlv二进制，还得有go工具链，否则dlv debug会报cannot find package - 别用
sudo dlv启动调试器——权限错位会导致 VSCode 连不上，也别把dlv放在/root/bin却用普通用户 SSH 登录
launch.json 中最关键的三个配置项
远程调试失败，八成出在 launch.json 的路径映射和启动方式上。本地代码路径和远程实际路径不一致，断点全失效；用 exec 模式却没提前编译，dlv 直接退出。
-
program必须填远程绝对路径，比如/home/user/myapp/main.go，不能写./main.go或相对路径 -
env里补上GOPATH和GOROOT（如果远程没设全局环境变量），例如："GOPATH": "/home/user/go" - 推荐用
dlv exec模式而非dlv debug：先在远程go build -o myapp .，再在launch.json里设"mode": "exec", "program": "/home/user/myapp"——稳定、快、不依赖源码实时同步
Remote SSH 下 GOPROXY 和模块路径的坑
本地开 GOPROXY，远程没配，go mod download 就会卡住或拉错包；更隐蔽的是，VSCode Remote SSH 默认不加载 shell 的 .bashrc，导致 go env 显示的 GOPROXY 是空的，但终端里却是好的。
- 在远程服务器执行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐），避免调试时因拉包失败中断 - 检查
~/.bashrc是否有export GOPROXY=...，然后在 VSCode 的 Remote SSH 设置里打开"remote.SSH.enableAgentForwarding": true，并确保"terminal.integrated.profiles.linux"配置了正确的 shell 启动命令 - 如果项目用了私有模块（如
git.mycompany.com/go/lib），必须在远程go env -w GOPRIVATE=git.mycompany.com/go/*，否则dlv启动时会去公网 proxy 查找
调试连接不上？先看这三行日志
VSCode 底部状态栏显示 “Starting: dlv …” 就不动了，或者弹出 “Failed to continue: Error: connect ECONNREFUSED 127.0.0.1:2345”，别急着重装插件——先查日志源头。
立即学习“go语言免费学习笔记（深入）”；
- 打开 VSCode 的
Output面板，选Go标签，看有没有dlv启动命令被截断，或提示permission denied执行二进制 - 手动 SSH 到服务器，运行
ps aux | grep dlv，确认进程是否真在监听localhost:2345；如果监听的是127.0.0.1:2345，而 VSCode 尝试连localhost，某些 hosts 配置下会失败——统一用127.0.0.1 - 在
launch.json加上"dlvLoadConfig": { "followPointers": true, "maxVariableRecurse": 1, "maxArrayValues": 64, "maxStructFields": 64 }，避免大结构体触发dlv内存超限崩溃，这类失败不会报错，只静默退出
最常被忽略的是：远程 dlv 进程启动后，VSCode 并不自动转发端口，得确保 remote.SSH.remoteServerListenOnPort 是 false（默认），否则它会尝试走非标准通道，绕过你配的 2345 端口
