goroot必须指向go安装根目录（如/usr/local/go或c:\go），而非bin子目录，否则ide无法找到src、pkg等关键文件导致运行按钮灰掉、import标红；需重启goland生效，并配置go modules代理为https://goproxy.cn,direct且删除go.work文件。
GOROOT 必须指向根目录，不是 bin 子目录
GoLand 启动后右上角运行按钮灰掉、import 标红，90% 是因为 GOROOT 填错了路径。常见错误是把 /usr/local/go/bin/go 或 C:\Go\bin 当成 GOROOT —— 这会导致 IDE 找不到 src 和 pkg，无法解析标准库。
- 正确路径示例：
/usr/local/go（macOS/Linux）、C:\Go（Windows 默认）、$HOME/go（推荐用户级安装） - 验证方法：打开该路径，确认里面包含
src、pkg、bin三个文件夹 - 填完必须重启 GoLand —— 点
Apply或Reload project都不生效，GUI 进程不重读环境变量
Go Modules 代理必须带 direct
国内拉依赖超时、go mod download 卡住、私有模块解析失败，往往是因为代理配置漏了 direct。只写 https://goproxy.cn 会让 Go 尝试从代理拉所有模块，包括本地或企业内网模块，而它们根本不在代理上。
- Settings → Go → Go Modules → Proxy 填：
https://goproxy.cn,direct - 逗号分隔，中间**不能有空格**；
direct表示“无法通过代理获取的模块，直接连原始地址” - 如果项目根目录存在
go.work文件，删掉它 —— 它会强制启用多模块工作区，干扰单模块项目初始化 - 改完后右键项目根目录 →
Reload project（不是Sync），触发完整 module 解析
运行配置里 Working directory 别乱设
main.go 能编译但 panic: “file not found”，或者 http.ListenAndServe 绑定失败，常因工作目录不对。Go 程序里用相对路径读文件、加载模板、写日志时，都依赖当前工作目录（os.Getwd()）。
- 默认建议保持 Working directory 为项目根目录（即
go.mod所在位置） - 若想按当前文件运行（比如点
cmd/api/main.go旁的三角），则设为$FileDir$ - 绝对不要设成
$ProjectFileDir$或$ContentRoot$—— 这些变量在 GoLand 里行为不稳定，尤其跨模块时容易指向错误路径 - 调试时可在代码开头加
fmt.Println("wd:", os.Getwd())实时确认
go env 输出路径要全在用户目录下
执行 go env GOROOT 或 go env GOPATH 返回系统级路径（如 /usr/lib/go、C:\Program Files\Go），说明安装或配置时用了提权操作 —— 这会导致后续 go install、go get 权限失败，且难以清理。
- 优先用解压包方式安装：下载
go*.tar.gz或.zip，解压到$HOME/go或%USERPROFILE%\go - 手动设置
GOROOT=$HOME/go，PATH=$PATH:$GOROOT/bin，然后source ~/.zshrc（或对应 shell 配置） - 验证命令：
go env GOROOT GOPATH两个路径都应落在用户可写目录内 - Windows 上 MSI 安装务必取消勾选 “Install for all users”，选 “Just for me”
go.work 文件的存在和 direct 的拼写 —— 它们不会报错，但会让依赖行为变得不可预测，debug 成本远高于提前删掉或补全。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
