GOROOT必须指向Go安装根目录（如D:\Go），而非bin子目录，否则GoLand提示“No Go SDK found”或运行按钮灰色；需验证路径含src/pkg/bin三目录、go env GOROOT输出一致，并重启IDE生效。
GOROOT路径必须指向Go安装根目录，不是bin子目录
GoLand启动时提示“No Go SDK found”或运行按钮灰色，90%是因为GOROOT填错了。它必须是D:\Go或C:\Go这种包含src、pkg、bin三文件夹的顶层路径，不能填D:\Go\bin——后者会导致gopls无法加载标准库，IDE直接放弃代码补全和跳转。
验证方式很简单：打开CMD，执行go env GOROOT，输出值必须和GoLand里Settings → Go → GOROOT中填写的一致，且该路径下能直接看到src文件夹。如果已错填，改完后务必关闭并重启GoLand——点“Apply”不生效，GUI进程不会重读配置。
- Windows默认.msi安装若选了
C:\Program Files\Go，因空格会触发路径解析失败，go build报exec: "gcc": executable file not found in %PATH%之类错误，必须卸载重装到扁平路径（如D:\Go） - macOS/Linux用户用Homebrew安装的，
GOROOT通常是/usr/local/opt/go/libexec，不是/usr/local/bin/go - 别手动修改系统环境变量里的
GOROOT来“配合”IDE——GoLand只认自己设置的值，系统变量仅影响命令行
go.mod存在但import标红，本质是模块未被识别
新建项目后写import "fmt"也标红，或go run main.go成功但GoLand里fmt无法跳转，说明IDE没把当前目录当module根。这不是代码问题，而是模块感知断连。
关键检查点只有三个：go.mod文件必须在项目根目录（不是子文件夹），不能被同目录下的go.work覆盖（有就删掉），且GoLand必须以“文件夹方式”打开整个项目根——只双击main.go打开，IDE根本不知道这是个module。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 命令行快速验证：在项目根目录下执行
go list ./，能列出command-line-arguments才表示module加载成功 - VS Code用户常忽略这点，但GoLand更严格：右下角状态栏必须显示
gopls (running)和你的模块名（如example.com/myapp），否则就是没认对根 - 如果刚执行过
go mod init example.com/myapp，但IDE仍不识别，尝试File → Close Project，再用“Open Folder”重新打开根目录
GOPROXY配置不对，第三方包永远下载失败
import "github.com/gin-gonic/gin"爆红、go get -u github.com/gin-gonic/gin卡住或报no required module provides package，基本等于代理没配对。Go 1.21+默认启用Modules，但不设代理在国内几乎无法拉取任何外部依赖。
正确写法是https://goproxy.cn,direct（注意逗号分隔，结尾direct不能漏）。这个值要同步设在两处：命令行执行go env -w GOPROXY=https://goproxy.cn,direct，以及GoLand Settings → Go → Go Modules → GOPROXY字段里手动填一模一样的字符串。
- 别用
https://goproxy.io——该域名已于2025年停止服务，现在访问会返回404 - 别加
https://proxy.golang.org在前面——国内直连失败后不会自动fallback，direct才是最后兜底项 - 改完后不需要重启GoLand，但首次下载依赖时建议清空缓存：File → Invalidate Caches and Restart → “Just Restart”
GoLand调试器启动失败，往往卡在工作目录配置
点击绿色三角能运行，但点击虫子图标（Debug）直接失败或无响应，大概率是Run Configuration里的Working directory没设对。它必须是项目根目录的绝对路径，常见错误是留空、填成$ProjectFileDir$/src或误写成GOPATH路径。
正确做法：进入Run → Edit Configurations → 选中你的go run配置 → 右侧找到Working directory → 点右边文件夹图标，选择项目最外层文件夹（即含go.mod的那个）。这个路径会自动转为$ProjectFileDir$变量，千万别手敲。
- 如果项目结构是
myproject/go.mod+myproject/cmd/main.go，Working directory就必须是myproject，不是myproject/cmd - GoLand 2024.3+版本对
GO111MODULE已完全忽略，不用管环境变量里是否设了on——Modules是硬编码启用的 - 真正容易被忽略的是：GoLand不读取系统PATH里的
go命令路径，它只用自己的GOROOT/bin/go。所以即使命令行能跑，IDE里debug失败，也得回头检查GOROOT是否真指向有效安装目录
