goland安装后必须手动配置goroot、gobin和模块代理，否则新建项目失败、代码跳转失效、断点不触发；goroot需手动指定真实路径（如/usr/local/go或c:\go），gobin须加入系统path并确保gopls可执行，模块代理应设为https://goproxy.cn,direct。
GoLand 装完不能直接写代码——这不是 Bug，是设计如此。必须手动配好 GOROOT、GOBIN 和模块代理，否则新建项目失败、跳转失效、断点不触发。
GOROOT 必须手动填，别信 Auto-detect
GoLand 不会自动识别你系统里装的 Go，尤其当你有多个版本（比如 go1.21 和 go1.22）时，“Auto-detect”大概率选错路径，导致后续所有功能异常。
- 打开
Settings > Go > GOROOT，手动填入真实安装路径：/usr/local/go（Linux/macOS）、C:\Go或你自定义的路径（如D:\tool\go） - 确认该路径下存在
bin/go文件，终端执行go version应能正常输出版本号 - 如果用非标准方式安装（如解压
tar.gz到家目录），路径要精确到~/go这一级，不能只填~
GOBIN 必须在 PATH 里，否则 gopls 启动失败
gopls 是 GoLand 语义分析、跳转、补全的核心语言服务器，它不是 IDE 自带的，而是靠 go install 安装到 GOBIN 目录。如果终端里都找不到 gopls，GoLand 就会降级为纯文本编辑器。
GoLand 2026.1.1
下载
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路径加进系统PATH环境变量，并重启 GoLand（不是仅重载项目） - 检查 GoLand 底部状态栏右下角是否有
gopls连接图标；没图标或显示 “not connected”，说明没生效
新建 Go Module 项目卡住？先看路径和代理
点击 New Project > Go Module 后空白、卡住，或报 cannot find module providing package，90% 是路径或代理问题，跟 IDE 本身无关。
- 项目路径不能含中文、空格、特殊符号（如
~/Desktop/我的项目→ 改成~/go/src/myapp） - 确保
Settings > Go > Modules中勾选了Enable Go modules integration，且Proxy设为国内可用地址：https://goproxy.cn或https://mirrors.aliyun.com/goproxy/（末尾保留,direct） - 如果已有
go.mod但 GoLand 没加载，不要重启 IDE，右键项目根目录 →Reload project - 首次新建时模块名建议用完整路径格式，如
github.com/yourname/hello，避免只输hello
调试器 dlv 静默退出？版本不匹配是主因
断点设了但程序一闪而过、控制台无输出、甚至报 could not launch process: fork/exec /path/to/dlv: no such file or directory，基本就是 dlv 没装或版本不匹配。
- 执行：
go install github.com/go-delve/delve/cmd/dlv@latest - 验证：
dlv version输出的 Go 版本应与当前项目使用的 Go 版本一致（例如项目用go1.22，dlv也需基于go1.22编译） - GoLand 默认调用的是系统 PATH 中的
dlv，不是go install安装的那个——确认which dlv输出路径与go env GOBIN一致 - 若仍失败，在
Run > Edit Configurations > Go Build中手动指定dlv路径
最容易被忽略的其实是路径合法性：GoLand 对项目路径的字符容忍度极低，一个中文、一个空格、一个波浪号（~）没展开，就足以让 gopls 断连、go mod 加载失败、调试器无法启动——这些错误不会明确提示“路径非法”，只会表现为功能静默失效。
