dlv必须手动安装并验证版本兼容性，远程需执行go install github.com/go-delve/delve/cmd/dlv@latest并运行dlv version确认输出正常；go 1.22+建议用dlv v1.23+，否则api-version 2不兼容导致断点失效；禁止sudo启动，需严格匹配host、port、api version三要素，防火墙与路径映射须同步校验。
dlv 必须手动安装并验证版本兼容性
GoLand 不会帮你装 dlv，也不会检查它和 Go 版本是否匹配。远程机器上必须自己执行：go install github.com/go-delve/delve/cmd/dlv@latest，然后运行 dlv version 确认输出正常。若本地 Go 是 1.22+，建议用 dlv v1.23+；低于此版本可能触发 api-version 2 不兼容，断点直接失效。
常见错误现象：dlv --help 报错找不到命令，或 dlv version 输出空白——说明 PATH 没配对，或安装时 GOPATH/bin 未加入环境变量。
别用 sudo dlv 启动：GoLand 默认以普通用户连接，sudo 会导致权限 mismatch，连接后秒断。真需要 root 权限（比如调试 kube-apiserver），改用：dlv --accept-multiclient --only-same-user=false。
Go Remote 配置三要素必须和远程命令严丝合缝
在 GoLand 的 Run Configuration → Go Remote 中填的 Host、Port、API Version，必须和你在终端里实际敲的 dlv 命令参数完全一致，差一个空格或冒号都会连不上。
例如远程启动命令是：dlv debug --headless --listen :2345 --api-version 2 --accept-multiclient，那么：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
Host填远程 IP 或可解析域名（不是localhost） -
Port填2345（注意：--listen :2345中的冒号是dlv语法，Port字段只填数字） -
API version填2（不能写v2或留空）
防火墙常被忽略：远程需放行该端口，ufw allow 2345 或 iptables -I INPUT -p tcp --dport 2345 -j ACCEPT；云服务器还得同步检查安全组规则。
源码路径映射错，断点永远不命中
GoLand 断点靠本地路径和远程路径的映射关系来定位代码行。dlv 加载的是远程绝对路径（如 /home/user/myproj/main.go），IDE 显示的是本地路径（如 /Users/me/myproj/main.go），两者不映射，断点就只是灰色圆圈。
映射配置在：Tools → Deployment → Configuration → Mappings，检查：
-
Local path和Deployment path必须严格一一对应，结尾斜杠要一致（/home/user/proj≠/home/user/proj/） - 远程项目用
go mod，确保go.mod和go.sum是当前用户可写（ls -l go.*，必要时chown $USER:$USER go.*） - 同步后仍不生效？先点
File → Synchronize刷新本地状态，再打开Tools → Deployment → Browse Remote Host看文件是否真传过去了
远程 go run 报 “cannot find module providing package”
这不是 GoLand 的锅，而是远程环境没准备好模块依赖。典型原因是：
- 远程没初始化
GOPATH或GOMODCACHE，执行go env GOPATH和go env GOMODCACHE看路径是否存在、是否可写 - 远程没执行
go mod download，或者GO111MODULE=on没生效（检查go env输出） - 远程
GOROOT和本地不一致，导致编译产物路径错乱（尤其跨平台调试时）
最省事的验证方式：SSH 进去，cd 到项目目录，手动跑一遍 go run main.go —— 如果这步都失败，远程调试根本走不到断点那一步。
