goland 能运行取决于三件事：本地 go 命令可用、goroot 指向正确、项目启用 go modules；任一缺失都会导致运行按钮灰色，且必须彻底重启才能生效。
GoLand 能不能跑起来，不取决于你点了多少个“下一步”，而取决于三件事：本地 go 命令可用、GOROOT 指向正确、项目启用 Go Modules。漏掉任何一项，右上角的绿色运行按钮就永远是灰色的。
确认本地 go 命令已就绪且可被识别
GoLand 不会自带 Go 编译器，它只调用你系统里已安装的 go 二进制。如果终端里执行 go version 报 command not found，GoLand 就完全无法工作。
- Windows 用户：检查
C:\Go\bin（或你自定义路径如D:\Soft\Go\bin）是否已加入系统PATH；若手动改过安装路径，.msi 默认配置不会生效，必须自己加 - macOS 用户：运行
echo $PATH，确认含/usr/local/go/bin；若没有，编辑~/.zshrc，追加export PATH=$PATH:/usr/local/go/bin，再执行source ~/.zshrc - Linux 用户：同 macOS，注意实际路径可能是
/home/xxx/go/bin，取决于你解压.tar.gz的位置 - 验证方式：关掉所有终端窗口，新开一个，执行
go version和go env GOROOT，两者都必须有合理输出
在 GoLand 中手动设置 GOROOT 并彻底重启
GoLand 的 “Auto-detect” 在多版本共存或非标路径下基本不可信。它需要你明确指定根目录，且该目录下必须包含 src、pkg、bin 三个子目录——选错成 bin 目录本身就会导致后续全部失效。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → GOROOT（macOS 是 Preferences），点击右侧文件夹图标，选择 Go 安装根路径（如
C:\Go、/usr/local/go） - 选完后点
Apply，但别点 OK 就完事——必须关闭整个 GoLand 进程（包括后台服务），再重新启动 - 重启后新建
main.go，写一行fmt.Println("ok")，观察：无红色波浪线 + 右上角三角变绿 = 成功；仍有波浪线或三角灰着，说明GOROOT未生效
新建项目时必须选 Go module，且立刻验证 go.mod
GoLand 2025+ 对非模块项目支持极弱。用 “Empty Project” 或 “Go”（非 module）模板创建，即使后期补 go mod init，索引、跳转、依赖提示也大概率异常。
- File → New Project → 左侧选
Go→ 右侧模式务必选Go module - 模块名填合法标识符即可，如
example.com/hello（域名不需真实存在，但不能是纯数字或含空格） - 项目创建后，第一件事是看根目录是否存在
go.mod文件；没有就删掉重来，不要试图修复 - 国内用户务必同步配置代理：Settings → Go → Go Modules → 勾选
Enable Go modules integration，Proxy 填https://goproxy.cn,direct（注意逗号，direct不可省）
运行 hello.go 前先检查当前文件是否在 module 根目录下
GoLand 的运行按钮默认执行的是当前文件所在模块的 go run .。如果 hello.go 不在 go.mod 所在目录（或其子目录），或者该文件没被 go.mod 包含，就会报 no Go files in current directory 或直接静默失败。
- 确保
hello.go放在项目根目录（即有go.mod的那层），且package main+func main()结构完整 - 不要把文件建在
src、cmd等子目录下再指望一键运行——除非你明确知道怎么配Run Configuration - 最简验证：根目录下新建
main.go，内容仅含package main和func main() { fmt.Println("Hello") }，保存后直接点绿色三角
最容易被忽略的其实是重启动作：改完 GOROOT 或代理后只点 “Reload project”，根本不起作用。GoLand 的 Go 集成是进程级加载的，不杀干净重来，配置就只是摆设。
