必须确认远程主机已安装go且环境变量生效，否则go remote调试将失败；需在ssh终端执行go version和env验证goroot、gopath、path，修复后选用go remote配置并确保部署路径映射正确、权限匹配。
远程运行代码前，必须确认 Go 环境在远程主机上可用
本地装了 Go 没用，go version 必须在远程服务器上能执行成功。常见失败现象是运行时提示 command not found: go 或退出码 126——这几乎 100% 是远程端没装 Go，或 GOROOT/PATH 没生效。
验证方式很简单：在 GoLand 的 SSH Terminal（Tools → SSH Terminal）里直接运行 go version 和 env | grep -E "(GOROOT|GOPATH|PATH)"。如果输出为空或路径错误，别急着配运行配置，先 SSH 登录服务器手动修复环境变量，再 source /etc/profile 或 source ~/.bashrc。
- Ubuntu/Debian 建议用
sudo apt install golang安装，避免手动解压后漏配PATH - 若用
wget下载二进制包，务必补上export PATH=$PATH:$GOROOT/bin -
/etc/profile修改后需 root 权限，且新 SSH 会话才生效；GoLand 的运行配置默认不读取~/.bashrc，只认登录 shell 加载的环境
选对运行配置类型：Go Remote 而不是 Local
在 Run → Edit Configurations 里新建配置时，选 Go Remote，不是 Go Build 或 Go Test。后者只在本地执行，完全不走远程。
Go Remote 配置的核心字段只有三个必须填对：
-
Host：填远程服务器 IP 或域名（不是localhost） -
Port：填 Delve 调试器监听端口，默认2345，但得确保远程已运行dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./your-binary -
Program：填远程服务器上编译好的可执行文件绝对路径，例如/home/user/myapp/main，不是本地main.go
注意：Go Remote 不负责编译，它只负责启动远程进程并附加调试器。编译得提前做——要么用 Tools → Deployment → Upload to … 上传源码后 SSH 手动 go build，要么用部署配置自动同步 + 远程构建脚本。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
部署路径映射错，代码根本没传过去
很多人卡在“运行没报错，但远程没反应”，其实是本地改了代码，却没同步到远程对应路径。GoLand 的部署（Deployment）和运行（Run）是两套独立机制。
检查 Build, Execution, Deployment → Deployment 是否配置了 SFTP，并确认 Mappings 页签里：
-
Local path指向你本地项目根目录（如/Users/me/mygo） -
Deployment path填远程目标目录绝对路径（如/home/user/mygo），不能是相对路径 - 勾选
Upload external changes automatically，否则 Ctrl+S 保存后不会自动上传
上传后，建议在 SSH Terminal 里 ls -l /home/user/mygo 看时间戳是否更新。别依赖 IDE 右键菜单里的“Upload”——那是一次性操作，日常开发必须靠自动同步。
权限和用户上下文经常被忽略
SSH 连接用的是哪个用户，远程所有操作就运行在该用户上下文下。典型坑点：
- 部署路径设成
/root/project，但 SSH 登录用户是dev，结果Permission denied - 远程
go build输出二进制到$GOPATH/bin，但该目录属主是root，dev用户无权执行 - 防火墙或 SELinux 拦截了
2345端口，telnet remote-ip 2345连不通
最稳妥做法：所有路径都放在当前 SSH 用户家目录下（如 /home/dev/mygo），GOROOT 和 GOPATH 也设在此用户环境下生效，避免跨用户权限纠缠。
