goland环境搭建需手动配置goroot指向根目录（如/usr/local/go）、设置代理为https://goproxy.cn,direct、删除go.work、重载项目并确保路径无中文空格，否则fmt标红、运行按钮灰掉。
GoLand 环境搭建不靠“自动检测”，也不靠反复重启猜路径——真正省心的做法，是让系统、IDE 和项目三者在明确规则下各司其职，避免交叉污染。
GOROOT 必须手动指定且指向根目录
GoLand 从不读取系统 GOROOT 环境变量，也不会自动识别你装在 /usr/local/go/bin/go 的二进制。它只认你填进去的完整安装根路径。
- 正确路径示例：
/usr/local/go（macOS/Linux）、C:\Go（Windows 默认）、$HOME/sdk/go1.22.3（asdf 管理时） - 错误路径示例：
/usr/local/go/bin、C:\Go\bin\go.exe——会导致fmt包标红、右上角运行按钮灰掉 - 验证方式：打开该路径，确认存在
src、pkg、bin三个子目录 - 填完必须关闭并重启 GoLand——点
Apply或Reload project都无效，GUI 进程不重载环境上下文
Go Modules 代理要 CLI 和 IDE 双设置
只在 GoLand Settings 里填 https://goproxy.cn，而没在终端执行 go env -w GOPROXY=https://goproxy.cn,direct，会导致命令行 go get 成功但 IDE 里 import 仍标红。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
direct不可省略：缺它会导致私有模块、本地replace或新版包拉取失败 - 逗号分隔无空格：
https://goproxy.cn,direct✅；https://goproxy.cn, direct❌（空格会让 Go 解析为两个无效地址） - 删掉项目根目录下的
go.work文件：它会强制启用多模块工作区，干扰单模块项目初始化 - 改完后右键项目根目录 →
Reload project（不是Sync），触发完整 module 解析流程
运行配置别依赖“当前文件位置”惯性
很多用户习惯点 cmd/api/main.go 旁的绿色三角运行，却没意识到默认工作目录是项目根目录，而代码里用 ./templates 或 os.ReadFile("config.yaml") 时，实际路径可能错位。
- 推荐做法：保持
Working directory为$ProjectFileDir$（即go.mod所在目录），这是绝大多数 Go 项目约定的行为基准 - 若真需按文件位置运行（如调试某个子命令），设为
$FileDir$，并在代码开头加fmt.Println("wd:", os.Getwd())实时确认 - 绝对避免设成
$ContentRoot$或自定义绝对路径——跨机器或换分支后极易失效 - 注意：
go run main.go和go run .行为不同：前者不解析import路径，后者才走 module 规则
dlv 调试器必须由 go install 生成且路径可达
GoLand 提示 could not launch process: fork/exec ... no such file or directory，95% 是因为 dlv 二进制根本不在 PATH 中，或者版本与当前 Go 不兼容。
- 安装命令必须是：
go install github.com/go-delve/delve/cmd/dlv@latest（不是go get） - 验证是否生效：
which dlv应输出类似/home/user/go/bin/dlv；若为空，检查go env GOBIN并把该路径加入 shell 的PATH - Go 1.21+ 必须配 dlv 1.21+：复用旧版 dlv（如 1.20.x）会导致静默崩溃，无报错但断点不命中
- GoLand 内置 Terminal 若未继承系统 shell（比如 macOS 上 IDE 配了 bash，但终端用 zsh），
dlv就不可见——可在Settings → Tools → Terminal中统一 shell 类型
最常被忽略的其实是路径洁癖：项目路径含中文、空格、符号（如 ~/Desktop/我的项目），或 GOROOT 在 C:\Program Files\Go 这类带空格路径，都会导致 gopls 初始化失败、module 解析中断——这些错误不报红，只静默降级，排查成本远高于一开始就用干净路径。
