GoLand首次启动必须手动配置GOROOT（指向Go安装根目录）、显式设置GOPATH（建议干净路径如~/go-workspace）、配置GOPROXY（如https://goproxy.cn,direct），否则新建项目报“no Go SDK configured”，main.go标红，模块无法识别。
GoLand首次启动必须做的三件事
不配置这三项，新建项目会直接报错“no Go SDK configured”，连 main.go 都标红。不是功能没开，是底层根本没连上 Go 运行时。
- 关闭所有已打开的 CMD / PowerShell 窗口（否则
go env读到的是旧环境） - 启动 GoLand → 新建项目 → 弹出 “No SDK” 提示时，点 Configure SDK → 选
Go SDK→ 浏览到你安装 Go 的路径，比如D:\Soft\Go或/usr/local/go - 进
File → Settings → Go → GOPATH，确认路径不为空且不含中文、空格；若为空，手动填一个干净路径，如D:\gopath（Windows）或~/go（macOS）
国内开发者绕不开的 GOPROXY 配置
不配代理，go mod download 十次有九次超时，go get github.com/gin-gonic/gin 可能卡住十分钟不动。这不是网络问题，是 Go 默认直连 proxy.golang.org 被阻断。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在终端执行（非 IDE 内置终端）：
go env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org - 验证是否生效：
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux），输出应含https://goproxy.cn - 注意：IDE 内置终端可能缓存旧环境变量，重启 GoLand 才能同步；如果仍拉包失败，检查公司防火墙是否拦截了
.cn域名
必装的三个插件：中文、GitLens、Rainbow Brackets
官方插件市场里搜名字就能装，但顺序和时机有讲究——中文插件必须第一个装，否则后续界面全是英文，选项位置都找不到。
-
Chinese (Simplified) Language Pack：装完立刻点 Restart IDE，别手快点跳过 -
GitToolBox（不是 GitLens）：GoLand 原生 Git 支持弱，这个插件补全了当前行 commit 记录、分支差异预览、.gitignore 智能提示等硬需求 -
Rainbow Brackets：嵌套多层if+for+func时，括号颜色自动分层，比靠缩进靠谱得多；Go 里常有defer func() { }()这种写法，没它极易漏掉闭合
容易被忽略的 Go Modules 全局开关
很多老项目用 vendor 目录管理依赖，但新项目默认走 Go Modules。如果 go.mod 文件存在却提示 “module not found”，大概率是 IDE 里模块开关被关了。
- 路径：
File → Settings → Go → Go Modules - 确保勾选 Enable Go Modules integration，且
Go version下拉框选的是你本地实际版本（如1.25），不是 IDE 自带的假版本 - 如果项目根目录没有
go.mod，但你想启用模块，不要手动创建空文件——右键项目根目录 → New → Go Module，让 IDE 自动生成带正确module声明的文件
GOROOT 和 GOPATH 路径里混进了中文、空格或符号链接。每次重装前，先删掉 ~/.GoLand2026.x/config/options/go.xml 和 ~/Library/Caches/JetBrains/GoLand2026.x（macOS）这类缓存目录，比反复激活更管用。 
