GOROOT必须指向Go安装根目录（含src/pkg/bin），填错或指向bin子目录会导致GoLand运行按钮灰掉、import标红；GOPATH在模块时代非必需，但影响go install输出路径，不可与GOROOT混用。
GOROOT 必须指向 Go 安装根目录（含 src、pkg、bin 三个子目录），填错或指向 bin 子目录是 GoLand 运行按钮灰掉、import 标红的最常见原因；GOPATH 在模块时代已非必需，但若要使用 go install 或兼容旧脚本，仍需设置为独立路径，且不能与 GOROOT 混用。
GOROOT 填错会导致 IDE 找不到标准库
GoLand 启动后右上角“运行”按钮不可点、fmt 等基础包标红、点进函数跳转失败——这些不是代码问题，而是 IDE 没加载到 Go SDK 的源码和编译产物。根本原因是 GOROOT 被设成了 C:\Go\bin 或 /usr/local/go/bin 这类错误路径。
- 正确路径示例：
C:\Go（Windows 默认）、/usr/local/go（macOS/Linux Homebrew）、$HOME/sdk/go（手动解压） - 验证方式：打开该路径，确认里面同时存在
src、pkg、bin三个同级文件夹 - Windows 用户注意：
GOROOT值末尾**不要加反斜杠**（如C:\Go\是错的） - 改完必须重启 GoLand ——
Apply或Reload project都不生效，GUI 进程不重读环境变量
GOPATH 不再决定项目位置，但影响 go install 输出
Go 1.16+ 默认启用模块（GO111MODULE=on），go run 和 go build 不再依赖 GOPATH/src 结构。你完全可以把项目放在 D:\myapp 或 ~/dev/myapi，只要目录里有 go.mod 就能正常工作。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
go install生成的二进制默认输出到$GOBIN，而$GOBIN默认等于$GOPATH/bin - 若未设
GOBIN，又没配GOPATH，go install会把可执行文件写进$GOROOT/bin（你通常不希望这样） - Windows 用户应将
GOPATH设为**用户变量**（不是系统变量），值可设为D:\go-workspace或%USERPROFILE%\go -
Path中需包含%GOPATH%\bin，否则终端里无法直接运行go install生成的命令
GoLand 里配置 GOROOT/GOPATH 的实操要点
GoLand 的 Settings → Go → GOROOT 页面，本质是告诉 IDE “用哪个 Go SDK”，它不读取系统环境变量，而是自己维护一套映射。即使系统里 GOROOT 配对了，IDE 里没选对照样报错。
- 打开
Settings → Go → GOROOT，点击+→Add SDK→Local，然后选择 Go 安装根目录（如C:\Go），**不是bin子目录** - 如果列表里已有 SDK 但路径不对，先删掉再重新添加；仅修改文本框里的路径不生效
-
GOPATH在 Settings → Go → GOPATH 中设置，值建议与系统环境变量一致，但 IDE 不强制要求两者相同 - 若项目根目录存在
go.work文件，GoLand 会强制进入多模块工作区模式，单模块项目可能无法识别 —— 直接删掉它，再右键项目 →Reload project
代理和工作目录这两个坑比 GOROOT/GOPATH 更容易被忽略
很多人调通了 GOROOT 和 GOPATH，结果 go mod download 卡住、私有模块 replace 失效、甚至 go list -m all 报 not in a module，问题往往出在代理或工作目录上。
-
GOProxy必须带direct：填https://goproxy.cn,direct（逗号分隔，**中间不能有空格**），否则 Go 会尝试从代理拉所有模块，包括本地replace或内网仓库 -
Working directory在 Run Configuration 中必须设对：单模块项目应为$ProjectFileDir$（即go.mod所在目录），不是$ContentRoot$或$ProjectFileDir$/.. - 调试时可在
main.go开头加fmt.Println("wd:", os.Getwd())，确认当前工作目录是否符合预期 - 执行
go env GOROOT返回/usr/lib/go或C:\Program Files\Go，说明安装时用了管理员权限 —— 这会导致后续go install权限异常，建议重装到用户目录
