goland运行按钮灰掉、import标红、test图标不出现，90%因goroot填错且未重启ide；goroot必须指向含src/pkg/bin的根目录（如/usr/local/go或c:\go），不可填bin子目录，改后须关闭并重启ide。
GoLand 里右上角运行按钮灰掉、import 标红、test 图标不出现——90% 是 GOROOT 填错了，且没重启 IDE。
GOROOT 必须指向根目录，不是 bin 子目录
填 /usr/local/go/bin 或 C:\Go\bin 是最常见错误。IDE 需要访问 src、pkg、bin 三个子目录才能索引标准库；填错路径会导致所有 import 报 “Unresolved reference”，连 fmt 都标红。
- 正确路径示例：
/usr/local/go（macOS/Linux）、C:\Go（Windows 默认）、$HOME/sdk/go1.22.3（asdf 管理的用户级安装） - 验证方法：打开该路径，确认存在
src、pkg、bin三个文件夹 - 填完必须关闭并重启 GoLand —— 点 Apply 或 Reload project 完全无效，GUI 进程不重读环境变量
Go Modules 代理必须带 direct，且不能有空格
只填 https://goproxy.cn 会导致私有模块或本地 replace 模块拉取失败，现象是 go run 成功但 go test 报 cannot find module providing package xxx。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → Go Modules → Proxy 栏填：
https://goproxy.cn,direct - 逗号前后**不能有空格**，否则 Go 解析失败，退化为默认
https://proxy.golang.org,direct - 若项目根目录存在
go.work文件，删掉它——它会强制启用多模块工作区，干扰单模块项目初始化 - 改完后右键项目根目录 → “Reload project”（不是 “Sync”），触发完整 module 解析流程
Working directory 设错会导致 panic: “file not found”
Go 程序中用相对路径读配置、模板或日志文件时，依赖 os.Getwd() 返回值。设错工作目录，http.ListenAndServe 绑定失败、ioutil.ReadFile("config.yaml") 找不到文件都是典型表现。
- 推荐保持 Working directory 为项目根目录（即
go.mod所在位置） - 若想点击任意
main.go旁的三角直接运行（比如cmd/api/main.go），则设为$FileDir$ - 绝对不要设成
$ProjectFileDir$或$ContentRoot$—— 这些变量在跨模块或多根项目中行为不稳定 - 调试时可在入口加
fmt.Println("wd:", os.Getwd())实时确认当前路径
go env 输出路径含系统级目录说明安装出问题
执行 go env GOROOT 返回 /usr/lib/go 或 C:\Program Files\Go，说明安装时用了管理员权限——这会导致后续 go install 生成的二进制无法被普通用户执行，CI 构建产物在另一台机器上可能 segfault。
- 推荐用户级安装：macOS/Linux 解压到
$HOME/sdk/goX.Y.Z，Windows 解压到%USERPROFILE%\sdk\goX.Y.Z - 手动配置
PATH指向其bin目录，并确保go env中所有路径都在用户目录下 - 验证方式：终端和 GoLand 内置 Terminal（Alt+F12）中运行
go version，输出必须一致且非空
真正卡住人的从来不是“装不装得上”，而是 GOROOT 路径细节、direct 是否遗漏、工作目录是否动态匹配——这些点错一个，后面 debug 两小时都未必能定位到根源。
