goland能运行不等于环境配对，90%问题源于goroot指向bin子目录而非根目录（如c:\go）、未初始化go.mod、代理缺direct或存在go.work文件，须重启ide、删go.work、勾选initialize go module并设正确working directory。
GoLand 能跑起来，不等于 Go 环境就配对了——90% 的新手卡在灰色运行按钮、import 标红、go run 成功但 IDE 报“no Go files”上，根源不是代码写错，而是 GOROOT 或模块识别没对。
GOROOT 必须指向根目录，不是 bin 子目录
GoLand 启动后右上角运行按钮灰掉、标准库 import 标红、fmt 无法跳转，大概率是 GOROOT 填错了。常见错误是把 C:\Go\bin 或 /usr/local/go/bin 当成 GOROOT。
- 正确路径必须包含
src、pkg、bin三个子目录，例如：C:\Go（Windows）、/usr/local/go（macOS/Linux）、$HOME/go（用户级安装） - 填完后必须**完全退出 GoLand 再重启**——点 “Apply” 或 “OK” 不生效，GUI 进程不重读环境变量
- 验证方式：打开该路径，手动确认是否存在
src目录；或在终端执行go env GOROOT，输出应与 IDE 中设置一致
新建项目时一定要勾选 “Initialize go module”
不勾选会导致项目无 go.mod，IDE 以过时的 GOPATH 模式解析，第三方包无法下载，go run 可能报 no required module provides package。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 创建新项目时，对话框里明确勾选 “Initialize go module”，模块路径可填
example.com/hello（域名形式非必需，但推荐） - 初始化后检查项目根目录下是否有
go.mod文件，内容至少含module example.com/hello和go 1.21（版本号随你装的 Go 版本变化） - 如果已建错，别删
go.mod后重试——关闭项目，删整个目录，重新 New Project 并勾选初始化 - 已有项目补救：在项目根目录终端执行
go mod init example.com/xxx，再右键根目录 → “Reload project”
代理必须带 direct，且逗号不能有空格
国内拉依赖超时、go mod download 卡住、私有模块解析失败，常因代理配置漏了 direct 或格式不对。
- Settings → Go → Go Modules → Proxy 填：
https://goproxy.cn,direct（注意：逗号前后**不能有空格**） -
direct表示“代理拿不到的模块，直接连原始地址”，缺它会导致本地路径、企业内网模块全失败 - 不要往 shell 配置文件（如
~/.zshrc）里硬写export GOPROXY=...——用go env -w GOPROXY=...统一管理更稳 - 如果项目根目录存在
go.work文件，删掉它——它会强制启用多模块工作区，干扰单模块项目
Working directory 别乱设，尤其别用 $ProjectFileDir$
go run main.go 成功，但 GoLand 运行按钮灰、调试器起不来，或者程序 panic 报 “file not found”，往往是工作目录不对。
- Run Configuration → Working directory 默认应为
$ProjectFileDir$（即go.mod所在目录），这是最安全的选择 - 若想按当前文件运行（比如点
cmd/api/main.go旁的三角），设为$FileDir$ - 绝对不要设成
$ContentRoot$或空值——这些变量在 GoLand 里行为不稳定，尤其跨模块时容易指向错误路径 - 调试时可在代码开头加
fmt.Println("wd:", os.Getwd())实时确认当前工作目录
最易被忽略的是：Go 1.16+ 默认启用 Modules，GOROOT 是 IDE 能否索引标准库的关键，而 go.mod 是否存在、direct 是否在代理列表里，决定了模块能否真正加载——这三者任何一个出错，都会让 IDE 表面正常、实际失能。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
