goland 启动前必须正确配置 goroot（指向 go 安装根目录，如 /usr/local/go）和 gopath（建议显式设为干净路径如 ~/go-workspace），并确保新建项目执行 go mod init 初始化模块，否则将导致包识别失败、代码补全失效及依赖管理异常。
GoLand 本身不依赖“模块化配置”这种抽象概念，它只是 IDE；真正需要你动手配置的是 Go 的模块系统（go mod）和项目结构，IDE 只是辅助。直接用 go mod init 初始化、配好 GOPATH 和 GOROOT 就能跑起来，别被“模块化配置”带偏。
GoLand 启动前必须确认的两个路径
GoLand 不会自动猜对 GOROOT（Go 安装根目录）和 GOPATH（工作区路径），填错会导致新建项目无法识别包、go run 报 command not found 或 cannot find package。
-
GOROOT应指向你安装 Go 的实际位置，比如/usr/local/go（macOS/Linux）或C:\Go（Windows），不是~/go—— 后者是GOPATH默认值 -
GOPATH建议显式设为一个干净路径，如~/go-workspace，避免和系统默认~/go混淆；GoLand 的 “Go Modules integration” 依赖它定位pkg和bin - 在 GoLand 中：File → Settings → Go → GOROOT / GOPATH，勾选 “Use GOPATH that is defined in system environment”，或手动填入——填完务必点 “Apply” 并重启项目
新建项目时别跳过 go mod init
GoLand 创建新项目时，默认可能用 GOPATH 模式（老式 vendor 管理），但 1.16+ 默认启用模块，跳过 go mod init 会导致 import 提示红色波浪线、代码补全失效、go get 不写入 go.mod。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 新建项目后，立刻在 Terminal 里执行：
go mod init example.com/myapp（域名部分可任意，只要合法） - 执行后会生成
go.mod和空的go.sum；此时 GoLand 才会激活模块感知，自动索引依赖、解析replace和exclude - 如果已建项目没
go.mod，不要删整个项目重来——进项目根目录执行go mod init即可，GoLand 会在几秒内刷新索引
go build 成功但 GoLand 仍报错？检查 go env 和 IDE 终端是否一致
常见现象：Terminal 里 go build 没问题，但编辑器里 import 包标红、fmt.Println 提示 “Unresolved reference”。根本原因是 GoLand 内置终端和代码分析引擎读取的环境变量不一致。
- 在 GoLand Terminal 中运行
go env | grep -E "(GOROOT|GOPATH|GO111MODULE)"，确认输出和 Settings 里填的一致 - 如果
GO111MODULE是off，强制设为on：go env -w GO111MODULE=on（需 Go 1.14+） - 重启 GoLand（不是 Reload project）——因为环境变量在启动时加载，改了
go env不重启无效 - 若用 zsh/bash profile 设置了
GOROOT，但 GoLand 启动方式是桌面图标（非终端启动），它可能读不到 shell 配置，这时必须在 Settings 里手动指定
真正卡住人的从来不是“怎么点菜单”，而是路径、环境变量、模块初始化这三处隐性依赖没对齐。哪怕只差一个字符，GoLand 就会静默降级为纯文本编辑器。
