GoLand 的 Build 菜单项（Ctrl+F9）默认仅作用于本地 SDK，即使配置了远程 Go SDK，也不会自动远程执行 go build；真正远程构建必须通过 Deployment 同步代码 + Run Configuration 显式绑定并勾选“Run on target host”来触发。
GoLand 本身不支持“远程自动构建”这个独立动作，所谓自动构建，本质是本地保存触发远程编译，必须靠 Deployment + Run Configuration 协同实现，且需手动指定构建命令。
为什么不能直接点“Build”就远程编译
GoLand 的 Build 菜单项（或 Ctrl+F9）默认只作用于本地 SDK。即使你已配置了远程 Go SDK，它也不会自动把 go build 发送到远程执行——它只是让 IDE 能正确解析语法、跳转和类型检查。真正的远程构建必须显式绑定到一个 Run Configuration 中。
Deployment 配置决定“代码怎么过去”
这是自动构建的前提：没有可靠的文件同步，远程构建必然失败。关键点如下：
- 必须使用
SFTP类型的 Deployment 配置（不是 FTP/FTPS），确保二进制兼容和权限保留 - 映射路径要精确：
Local path指向你的go.mod所在目录，Deployment path on server必须是远程服务器上可写的绝对路径（如/home/user/myproject），且该路径下已初始化go mod init - 启用
Automatic Upload (Always)，但注意：它只上传保存过的文件，不会上传go.sum变更等隐式依赖变化，首次部署建议手动Upload to...全量同步 - 勾选
Delete remote files when local are deleted，否则旧文件残留可能干扰go build -o输出覆盖
Run Configuration 决定“构建命令怎么跑”
这才是真正触发远程构建的地方：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入
Run → Edit Configurations → + → Go Build -
Run kind选Directory（不要选 File，除非你只构建单文件） -
Working directory填远程部署路径（如/home/user/myproject），不是本地路径 -
Output directory建议设为$ProjectFileDir$/bin并勾选Use output directory from deployment configuration，这样生成的二进制会自动同步回本地bin/目录 -
Go tool arguments可加-ldflags="-s -w"减小体积，但不要加-o到绝对路径——IDE 会自动处理输出位置 - 最关键：勾选
Run on target host，并选择你已配好的 SFTP Deployment 配置。此时点击Run或Debug，GoLand 才会通过 SSH 在远程执行go build
常见失败原因和绕过技巧
报错 command not found: go：远程 $PATH 未包含 Go 安装路径，不要改 GOROOT，而是在 Deployment 的 Connection → Environment variables 里显式设置 PATH=/usr/local/go/bin:$PATH
报错 cannot find module providing package ...：远程缺少 go.mod 或 go.sum，确认 Deployment 已同步这两个文件，且远程执行 go mod download 成功
想保存即构建？GoLand 没有原生 hook，但可用 External Tools 绑定 go build 命令 + Before launch 触发，不过这会绕过 Deployment 同步逻辑，容易出错，不推荐
真正稳定的“自动”流是：写完 → Ctrl+S（触发 SFTP 自动上传）→ Ctrl+Shift+F10（运行已配置的远程 Run Configuration）。中间没有黑盒，每步都可验证、可中断。
