goland 需手动配置 goroot、gobin 和模块代理才能正常开发：goroot 必须精确指向 go 根目录（含 src/pkg/bin），路径不能含中文、空格或波浪号，且需重启生效；gobin 必须加入系统 path 并确保 gopls 安装于此，否则语言服务失效；模块代理需在 cli 和 ide 中统一设置为如 https://goproxy.cn,direct，漏掉 ,direct 会导致私有模块解析失败；working directory 应设为 $filedir$ 或使用 go run ./cmd/xxx 避免路径错误。
GoLand 装完不能直接写代码，必须手动配好 GOROOT、GOBIN 和模块代理，否则新建项目失败、跳转失效、断点不触发——这不是 Bug，是设计如此。
GOROOT 必须手动指定，且路径要精确到根目录
GoLand 不会自动识别你系统里装的 Go，尤其当你有多个版本（比如 go1.21 和 go1.22）时，“Auto-detect”大概率选错路径。手动填错是导致右上角运行按钮灰掉、import 标红的最常见原因。
- 路径必须指向 Go 安装根目录，例如：
/usr/local/go（macOS/Linux）、C:\Go（Windows），不是/usr/local/go/bin或C:\Go\bin\go - 验证方式：打开该路径，确认里面包含
src、pkg、bin三个文件夹 - 路径含中文、空格或波浪号（如
~/Desktop/我的项目）会导致静默失败，务必改用纯英文路径 - 填完必须重启 GoLand —— 点 Apply 或 Reload project 都不生效，GUI 进程不重读环境变量
GOBIN 必须在系统 PATH 中，否则 gopls 启动失败
gopls 是 GoLand 实现跳转、补全、诊断的核心语言服务器，它不是 IDE 自带的，而是靠 go install 安装到 GOBIN 目录。如果终端里都找不到 gopls，GoLand 就会降级为纯文本编辑器。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先执行：
go install golang.org/x/tools/gopls@latest - 再执行：
which gopls（macOS/Linux）或where gopls（Windows），确认输出路径与go env GOBIN一致 - 若不一致，把
GOBIN路径加进 shell 的PATH环境变量，并重启 GoLand - 检查 GoLand 底部状态栏右下角是否有
gopls连接图标；没图标或显示 “not connected”，说明没生效
模块代理必须带 ,direct，且 CLI 和 IDE 设置要一致
只在 GoLand 设置里填 https://goproxy.cn 是不够的。终端命令行和 IDE 使用的代理不一致，会导致 go mod download 成功但 IDE 仍标红、或私有模块拉取失败。
- 终端执行：
go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外） - GoLand 设置中也要同步填入相同值：
Settings → Go → Go Modules → Proxy -
,direct表示“无法通过代理获取的模块（如本地路径、内网域名），直接连原始地址”，漏掉它会导致私有模块解析失败 - 逗号后不能有空格；若项目根目录存在
go.work文件，删掉它——它会强制启用多模块工作区，干扰单模块初始化
Working directory 设错会导致 panic: “file not found”
Go 程序里用相对路径读配置、加载模板、写日志时，全部依赖当前工作目录（os.Getwd()）。GoLand 默认设为项目根目录，但如果你点的是 cmd/api/main.go 旁的三角，实际运行时却从项目根去执行 go run main.go，就会找不到包或文件。
- 推荐两种安全做法：
– 编辑 Run Configuration →Working directory改为$FileDir$（即当前文件所在目录）
– 或统一用go run ./cmd/api形式，在Program arguments填子命令路径 - 绝对不要设成
$ProjectFileDir$或$ContentRoot$—— 这些变量在 GoLand 里行为不稳定，尤其跨模块时容易指向错误路径 - 调试时可在代码开头加
fmt.Println("wd:", os.Getwd())实时确认当前工作目录
最容易被忽略的其实是 GOROOT 和 GOBIN 的路径一致性，以及 go env 输出是否全落在用户目录下。如果 go env GOROOT 返回 /usr/lib/go 或 C:\Program Files\Go，说明安装时用了提权操作，后续 go install 生成的二进制可能权限异常，CI 上也会出问题。
