必须配对SSH、Go环境与dlv调试器才能运行：先手动验证ssh下go version/which go及GOROOT/GOPATH，确保非交互式shell可读；路径映射须精确一致；dlv需手动启动且参数匹配；同步选On explicit save；云服务器需开放安全组端口。
直接用 SSH 连远程服务器跑 Go 代码，不是“能不能”，而是“必须配对才跑得通”。GoLand 本身不托管 Go 环境，它只负责把代码传过去、调用远程 go 命令、连上 dlv 调试器——这三件事里任意一个路径/权限/版本没对上，就卡在“无法准备环境”或“连接超时”。
配置远程 Go SDK 前先确认 SSH 能真正执行命令
很多人卡在第一步：Test Connection 显示成功，但后续构建失败。这是因为 GoLand 的 SSH 测试只做登录握手，不验证 shell 环境是否完整。
- 手动用终端
ssh user@host登录，运行go version和which go，确保输出正常且路径可访问 - 检查远程
$GOROOT和$GOPATH是否已导出（env | grep -E 'GO(R|P)O'），仅写在~/.bashrc里不够——GoLand 启动的是非交互式 shell，通常只读~/.profile或/etc/environment - 如果用
sudo apt install golang安装，go二进制可能在/usr/bin/go；若用源码编译安装，常见路径是/usr/local/go/bin/go，必须填进 SDK 配置里的GOROOT字段，不能留空
添加 Remote Go SDK 时路径映射必须精确到字符
GoLand 把本地项目结构“投射”到远程路径，一旦映射错一位（比如多一个 /），go run 就会报 cannot find module providing package ——它根本找不到 go.mod。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在
Project Structure → SDKs → Add Go SDK → Remote SDK中，选好 SSH 配置后，关键字段是GOROOT（远程go安装根目录）和Project path on server（你希望代码上传到的远程绝对路径） -
Project path on server必须和你在 Deployment 配置里的Deployment path完全一致，包括结尾斜杠：若填/home/user/myproj，就别写成/home/user/myproj/ - 如果远程
go.mod所有者是root（例如用sudo go mod init），普通用户同步时会静默失败——用ls -l go.mod检查，必要时chown $USER:$USER go.mod go.sum
调试前必须手动启动 dlv 并核对所有参数
GoLand 的 Go Remote Debug 配置只是“客户端”，它不自动部署或启动 dlv。你得在远程终端里自己敲命令，且参数必须和 GoLand 里填的一致。
- 远程执行：
dlv --headless --listen :2345 --api-version 2 --accept-multiclient --only-same-user=false --continue（最后两个参数防止单次连接后断开） - GoLand 的 Run Configuration 中：
Host填远程 IP（不是localhost），Port填2345，且Working directory必须指向远程项目根目录（和上面Project path on server一致） - 别用
sudo dlv启动：GoLand 默认以普通用户身份连接，sudo启动的进程属于 root，权限隔离导致连接被拒绝 - 云服务器记得开安全组端口：不只是本地
ufw，阿里云/腾讯云后台的安全组也要放行2345
SFTP 同步失效时优先检查缓存与触发时机
改了代码点保存，远程没更新？大概率不是连接问题，而是同步策略没生效。
- 勾选
Tools → Deployment → Options → Upload changed files automatically → On explicit save action，别选On file change（它依赖文件系统 inotify，很多远程 SFTP 服务不支持） - 同步卡住时，先点
File → Synchronize强制刷新本地状态，再看Tools → Deployment → Browse Remote Host里文件时间戳是否真变了 - 如果远程路径含空格或中文，SFTP 可能解析异常——尽量用纯英文路径，如
/home/user/goprojects/myapp - GoLand 缓存有时会误判“已上传”，右键项目根目录 →
Upload to …是最可靠的兜底操作
最常被忽略的其实是环境变量加载顺序和非交互式 shell 的限制——你以为配好了 GOROOT，其实 go 命令在 GoLand 启动的子进程中根本没读到它。动手前先用 ssh 手动跑一遍完整流程，比对着文档点十次“Test Connection”更有效。
