GoLand 无法运行的主因是 GOROOT 设置错误、go 命令未被系统识别、项目未启用 Go Modules；三者缺一不可，需依次验证并重启 IDE。
GoLand 跑不起来，90% 不是授权问题、不是安装包损坏，而是 GOROOT 指错了、go 命令没被识别、或项目没走 Go Modules。这三件事缺一不可，漏掉任何一项，右上角绿色运行按钮永远灰色。
确认终端能调用 go 命令是前提
GoLand 不会帮你装 Go，也不继承你终端的 PATH —— 它只“看”你手动指定的 GOROOT，但前提是系统本身得先有可用的 go 二进制。
- 打开系统终端（不是 GoLand 自带 Terminal），执行
go version；必须输出类似go version go1.24.0 darwin/arm64的内容 - Windows 用户若用 .msi 安装但自定义路径（如
D:\Go），需手动把D:\Go\bin加进系统环境变量 PATH，并重启所有终端窗口 - macOS/Linux 用户检查
echo $PATH是否含/usr/local/go/bin；若无，编辑~/.zshrc或~/.bash_profile，追加export PATH=$PATH:/usr/local/go/bin，再执行source ~/.zshrc - 验证失败时，别急着配 GoLand，先解决
command not found: go—— 否则后续所有配置都是空中楼阁
手动设置 GOROOT 并彻底重启 GoLand
GoLand 2025+ 版本的 Auto-detect 在多版本共存或非标路径下基本失效。它必须看到你明确指向的根目录，且该目录结构必须完整。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入 Settings → Go → GOROOT（macOS 是 Preferences），点击右侧文件夹图标，选择 Go 安装根目录：Windows 是
C:\Go或D:\Go，macOS 是/usr/local/go，Linux 是/usr/local/go—— 注意不是/usr/local/go/bin - 打开该路径，确认存在
src、pkg、bin三个子目录；bin下必须有go和gopls可执行文件 - 点 Apply 后，必须关闭整个 GoLand 进程（包括后台服务），再重新启动；仅 “Reload project” 或 “Sync” 完全无效
- 验证方式：新建
main.go，写fmt.Println("ok")，看是否无波浪线、import "fmt"不标红、右上角绿色三角亮起
新建项目必须选 Go module 模式
用 “Empty Project” 或等导入后再补 go mod init，会导致索引异常、依赖不加载、运行配置无法识别入口 —— GoLand 2025 对非模块项目支持极弱。
- 启动 GoLand 后，选 New Project → 左侧选 Go → 右侧模式务必选
Go module，填模块名如example.com/hello（域名不重要，但不能纯数字、不能含空格或中文） - 项目创建后，立刻检查根目录是否有
go.mod文件；没有就删掉重来，不要手动go mod init - 国内用户必须配代理：Settings → Go → Go Modules → 勾选 Enable Go modules integration，Proxy 填
https://goproxy.cn,direct（注意逗号和direct缺一不可） - 项目路径禁止含中文、空格、符号（如
C:\Users\张三\Desktop\我的项目）；推荐用D:\go\src\hello这类扁平路径
Run Configuration 的 Working directory 必须设对
点击绿色三角报 “no Go files in current directory” 或 “cannot find package”，往往不是代码错，而是 IDE 执行时找错了起点。
- 右键项目根目录 → Reload project（不是 Sync），等状态栏出现
gopls (running)和模块名 - Run → Edit Configurations → 选中当前配置 → 确认
Working directory是$ProjectFileDir$，不能为空、不能填错成子目录路径 - 如果入口文件在
cmd/myapp/main.go，确保项目根目录下有go.mod，且该文件属于同一 module；否则 IDE 无法解析包路径 - 删掉项目根下的
go.work文件（多模块工作区会干扰单模块项目初始化）
最常被跳过的一步：改完 GOROOT 或代理后不关 IDE 重开 —— 所有配置都只是写进了内存，进程不重启等于没配。还有就是误把 GOROOT 指向 bin 目录，或者路径里混入中文/空格，这些细节一旦出错，IDE 就彻底“失明”。
