goland配置远程go sdk必须选remote sdk类型，通过ssh连接后手动填写goroot路径并确保远程shell正确加载环境变量，否则将导致go命令找不到或构建失败。
GoLand 本身不直接“配置 SSH 访问 Golang”，而是通过 SSH 连接远程服务器，再复用该服务器上的 Go SDK（即 Go 二进制、GOROOT、环境变量等）来完成编译、运行、调试——本质是把远程机器当成本地开发环境的延伸。
GoLand 添加远程 Go SDK 时选错连接类型
常见错误：在 Project Structure → SDKs → + → Add Go SDK 中误选 Local 或 Download，导致后续所有构建都在本地执行，根本没走 SSH。
- 必须选
Remote SDK（旧版叫Remote GDK），然后点右侧Configure按钮进入 SSH 配置页 - 如果 SSH 配置已存在，下拉选择即可；若没有，点
+新建，填Host、Port、Username - 认证方式优先选
OpenSSH config and authentication agent（依赖本地ssh-agent），比密码更稳定，也避免 Goland 缓存错误凭据 - 测试连接成功后，Goland 会自动尝试读取远程
go version和GOROOT；若失败，说明远程go不在$PATH中或未安装
远程 Go SDK 路径识别失败或 GOPATH/GOROOT 错乱
Goland 连上 SSH 后，会默认执行 go env GOROOT 和 go env GOPATH 获取路径。但很多服务器上 go 是手动解压安装、未写入 shell profile，或用户 shell 是 /bin/sh 导致 profile 不加载。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 登录服务器手动执行
which go和go env GOROOT，确认输出是否合理 - 如果
go在/opt/go/bin/go，但GOROOT显示空，说明go二进制未被正确识别为 SDK —— 此时需在 Goland 的远程 SDK 配置页中，**手动填写GOROOT路径**（如/opt/go），而非依赖自动探测 - 确保远程用户 shell 是
/bin/bash或/bin/zsh，并在~/.bashrc或~/.zshrc中导出GOROOT和追加$GOROOT/bin到PATH - 不要在 Goland 里手动设置
GOPATH：远程模块模式（Go Modules）下它基本无用；若真需要，应由远程go env返回，而非本地覆盖
SSH 连接能通，但 go build / run 报 “command not found” 或权限拒绝
现象是 Goland 显示 “Connected”，但点击 Run 按钮后终端报 /bin/sh: go: not found 或 permission denied，根源在于 SSH 会话环境与交互式登录环境不一致。
- SSH 默认启动的是 non-interactive shell，不会 source
~/.bashrc；而 Goland 的远程执行依赖这个 shell 环境 - 解决方法：在远程服务器的
~/.bashrc开头加上if [ -n "$PS1" ]; then包裹 PATH/GOROOT 设置，或更稳妥地，在~/.profile（被 login shell 读取）中设置，并确保~/.bashrc末尾有source ~/.profile - 检查 Goland 是否启用了
Use server's environment variables（通常在 Run Configuration → Environment →Pass environment variables to remote process）—— 勾选它，否则远程进程看不到GOROOT - 如果用的是密钥登录且私钥带密码，确保
ssh-agent已添加该密钥（ssh-add -l可查），否则 Goland 的后台连接可能静默失败
go get 私有模块失败，和 Goland 的 SSH 配置无关
这是高频误解：以为 Goland 配了 SSH 就能自动让 go get 走 SSH。实际上，go 命令调用的是系统 git，而 git 是否走 SSH 完全取决于 go.mod 里 require 的 URL 格式和本地 ~/.ssh/config。
-
go.mod中必须写 SSH 格式路径，例如git@github.com:org/private.git，不能写https://github.com/org/private.git - 确保
~/.ssh/config中对应 Host 有IdentitiesOnly yes和明确IdentityFile，否则 OpenSSH 可能因试错过多被服务器断连 -
GO111MODULE=on必须生效（go env GO111MODULE输出on），否则退化到 GOPATH 模式，忽略go.mod协议声明 -
GOPROXY若非direct，go 会绕过 SSH 直接走代理——私有模块必然失败，所以建议设为GOPROXY=direct或GOPROXY=https://proxy.golang.org,direct
最易被忽略的一点：Goland 的远程 SDK 配置只影响 IDE 内部的代码分析、构建和调试，**不影响你手动在 Terminal 里敲的 go 命令**——那个 Terminal 默认还是走本地 shell。如需统一，得在 Goland 的 Settings → Tools → Terminal → Shell path 改成 ssh user@host，但这属于高级定制，多数人没必要碰。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
