jetbrains gateway 不执行 go 编译，仅转发流量；编译和调试均由远程 go 环境完成，需手动安装验证 go/dlv 版本、路径、代理、权限及网络端口配置。
JetBrains Gateway 本身不参与 Go 编译，它只负责连接、部署 IDE 后端和转发调试/编辑流量；真正执行 go build 或 go run 的，始终是远程服务器上的 Go 环境——所以“云端编译”这件事，本质是你自己配对了正确的远程 Go 版本、GOROOT、GOPATH（或模块路径）和 dlv。
远程 Go 环境必须手动安装并验证
Gateway 不会帮你装 Go，也不检查远程是否能跑 go version。你得登录服务器亲手确认：
-
go version输出正常（比如go version go1.22.6 linux/amd64） -
which go返回路径在$PATH中，且 GoLand 远程配置里填的GOROOT与之严格一致（例如/usr/local/go） -
go env GOPROXY和GOMODCACHE与本地开发习惯一致；国内用户务必设go env -w GOPROXY=https://goproxy.cn,direct，否则go mod tidy在远程卡住是常态 - 如果要用
dlv调试，运行dlv version—— 它必须和本地 Go 版本兼容（Go 1.21+ 推荐 dlv v1.22+），且不能用sudo dlv启动，否则 GoLand 连上即断
映射路径错一个字符，同步就静默失败
GoLand 的 SFTP 同步依赖 “本地路径 ↔ 远程路径” 映射完全精确。常见坑点：
- 本地路径是
/Users/me/myproj，远程填成/home/me/myproj/（结尾多斜杠）→ 某些 SFTP 实现会当成不同目录，文件上传后实际落在/home/me/myproj//main.go - 远程
go.mod所有者是root:root，而你 SSH 登录用户是ubuntu→ 同步时写入失败，但 UI 不报错，只卡在 “Uploading…” - 没开 “Upload changed files automatically → On explicit save action”，改完代码 Ctrl+S，远程根本没更新，还傻等
go run生效 - 同步后远程文件权限变成
600，导致go run报错permission denied；手动chmod +x临时解决，长期应关掉 GoLand 的 “Preserve file permissions” 选项
调试端口、防火墙、云安全组三者必须全通
GoLand 远程调试失败，90% 是网络链路断在某一层：
- 你在远程跑
dlv --headless --listen :2345 --api-version 2，但本地 Run Configuration 里填的Port是2346→ 直接连不上 - 远程服务器开了
ufw或iptables，没放行2345端口 →telnet your-server 2345从本地连不通 - 你在 AWS/GCP/Azure 上跑服务器，云平台安全组默认只开
22→ 必须手动添加入站规则：TCP 端口2345，源 IP 可设为你的办公 IP 或0.0.0.0/0（测试用） - 别忽略
--accept-multiclient参数：没有它，dlv 接收一次连接后就退出，GoLand 断点命中后会立刻断开
最麻烦的不是配置本身，而是错误信息藏得深：GoLand 不告诉你 “dlv 未找到”，只显示 “Connection refused”；它也不提示 “go.mod 权限不足”，只让同步进度条空转。动手前先 ssh 登上去敲几行命令，比对着 GUI 点半小时更省时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
