goroot配置错误导致goland运行按钮灰掉，根本原因是填了如/usr/local/go/bin的子目录而非根目录，必须指向含src、pkg、bin的go安装根目录，且修改后需重启ide才能生效。
GOROOT 配置错，GoLand 运行按钮直接灰掉
GoLand 识别不了本地 go 命令，根本原因是 GOROOT 指向错误——不是路径填错，而是填了 /usr/local/go/bin 这类子目录。它必须是 Go 安装根目录，且该目录下要有 src、pkg、bin 三个文件夹。
macOS 默认路径是 /usr/local/go，Windows 是 C:\Go（不是 C:\Go\bin）。填完点 Apply 后，必须关闭并重启 GoLand，仅重载项目无效——GUI 进程不重启，环境变量不会重新加载。
验证方式很简单：新建 main.go，写一行 fmt.Println("ok")，如果右上角绿色三角亮起、没有红色波浪线，说明 GOROOT 对齐成功。
go mod download 卡住，八成是 GOPROXY 没生效
默认代理 https://proxy.golang.org 在国内基本不可用，但只执行 go env -w GOPROXY=https://goproxy.cn,direct 不够。Shell 新建进程时若未继承环境变量，go 命令仍会读到空值。
推荐做法是双保险：
- 执行
go env -w GOPROXY=https://goproxy.cn,direct - 同时在系统级环境变量里也设一遍（Windows 用
setx GOPROXY "https://goproxy.cn,direct"，macOS/Linux 加到~/.zshrc或~/.bash_profile） - 关键点：
,direct不能省——私有模块（比如公司内网 Git 地址）必须靠它 fallback 直连，否则replace或require私有路径会失败
验证是否真生效：运行 go mod download -x github.com/gin-gonic/gin@v1.9.1，看日志里请求的是 https://goproxy.cn/... 还是 https://proxy.golang.org/...。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
go.work 文件一存在，单模块项目就变多模块工作区
GoLand 新建项目时可能自动生成 go.work 文件，它会强制启用多模块工作区模式。哪怕你只有一个 go.mod，IDE 也会忽略它，导致依赖不加载、import 标红、测试图标不出现。
解决方法很直接：删掉项目根目录下的 go.work 文件，然后右键项目根目录 → “Reload project”。注意不是 “Sync”，后者只刷新缓存，前者才触发完整 module 解析流程。
如果你确实需要多模块开发，再手动建 go.work；否则，保持单模块项目干净，就别让它存在。
运行配置里的 Working directory 设错，main.go 就跑不起来
点击 main.go 旁的绿色三角运行时，GoLand 默认以项目根目录为工作目录执行 go run main.go。但如果入口文件不在根目录（比如在 cmd/myapp/main.go），就会报 no Go files in current directory。
两种解法：
- 统一用模块路径：Run Configuration → Program arguments 填
./cmd/myapp，Working directory 保持默认（项目根目录） - 按当前文件位置运行：Working directory 改成
$FileDir$，这样点击任意main.go时，都会以该文件所在目录为起点执行go run main.go
容易被忽略的是：GoLand 的 Run Configuration 是 per-file 的，改完一个文件的配置，其他 main.go 不会自动同步，得逐个检查或统一设模板。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
