GOROOT设错会导致GoLand找不到go命令；需通过go env GOROOT确认真实路径，Windows下避免中文、空格及尾部反斜杠，并在Settings→Go→GOROOT中手动指定含bin/和src/的根目录。
GOROOT 在 GoLand 里设错，IDE 就找不到 go 命令
GoLand 启动时会尝试读取 GOROOT 来定位 go、gofmt 等工具，如果它为空、指向错误路径，或路径末尾带反斜杠（如 D:\golang\），就会报 “Go SDK not found” 或执行 go run 时提示 cannot find package "fmt"。
实操建议：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先在终端运行
go env GOROOT，确认系统级真实值；Windows 用户注意：路径中不要含中文、空格，也不要加尾部\ - GoLand 设置路径：File → Settings → Go → GOROOT → Add SDK → Local → 选中你安装目录的根（必须包含
bin/和src/子目录） - 若用 asdf 或其他版本管理器，GoLand 能自动识别，但需确保该 shell 环境下
which go输出正常
GOPATH 不配或乱配，go install 生成的命令就找不到
模块时代 GOPATH 不再决定项目位置，但它仍控制 go install 的输出目录（默认写入 $GOPATH/bin），也影响旧脚本和 go get（无 go.mod 时）的行为。
常见错误现象：
-
go install成功但终端打不出命令：实际二进制被写到了$GOROOT/bin（因GOBIN未设，又没配GOPATH） - CI 脚本里硬编码了
$GOPATH/bin/mytool，本地却没这个路径
实操建议：
- 新项目可不设
GOPATH，或设为任意空目录（如D:\go-workspace） - 若需兼容旧流程，
GOPATH必须是独立路径（绝不能等于GOROOT），且 Windows 下应设为**用户变量**而非系统变量 - 显式设置
GOBIN：运行go env -w GOBIN=%GOPATH%\bin（Windows）或go env -w GOBIN=$GOPATH/bin（macOS/Linux）
IDE 启动方式导致环境变量不生效
桌面图标启动的 GoLand / VS Code 默认不继承 shell 的 .zshrc 或 PATH，即使你在终端里 go env 正常，IDE 内置终端或调试器仍可能报错。
实操建议：
- macOS：从终端执行
open -a "GoLand.app"或goland .启动，确保继承当前 shell 环境 - Windows：以管理员身份打开 PowerShell，再运行
start "" "C:\Program Files\JetBrains\GoLand 2025.2\bin\goland64.exe" - 通用兜底法：在 GoLand 的 Settings → Go → GOROOT 手动指定；并在 Debug 面板中点开 “Debug Console”，输入
go env确认实际生效值
GO111MODULE=on 必须显式开启，否则模块功能失效
哪怕你项目有 go.mod，只要 GO111MODULE 是 auto 或未设，进入 GOPATH/src 下的目录时，go list -m all 仍会报 not in a module，go get 也会退化为老式 $GOPATH/src 模式。
实操建议：
- 全局强制启用：终端运行
go env -w GO111MODULE=on - 别依赖
auto：它只在当前目录外有go.mod时才启用，极易误判 - 配合代理：顺手设好
go env -w GOPROXY=https://goproxy.cn,direct，避免依赖拉取失败
环境变量不是设完就一劳永逸的，GOROOT 和 GO111MODULE 这两个值一旦错配，问题往往藏得深——比如只在调试时暴露，或者只在特定子目录下触发。每次换 Go 版本、重装 IDE 或切换项目前，花 10 秒跑一遍 go env | findstr "GOROOT GOPATH GO111MODULE"（Windows）或 go env | grep -E "(GOROOT|GOPATH|GO111MODULE)"（macOS/Linux），能省掉大半排查时间。
