goland需正确配置go sdk、gopath、模块代理和delve调试器：指定goroot路径，gopath仅需存在且不继承系统环境变量；手动设置goproxy，启用go modules；调试选内置delve，run kind设为package，并同步default settings至新项目。
GoLand 能直接开箱运行 Go 项目，但默认配置不等于“适合你”——尤其在 GOPATH、Go SDK、模块代理和调试器行为上，稍不注意就会遇到 cannot find package、go: cannot load ...: malformed module path 或断点不命中等问题。
如何正确配置 Go SDK 和 GOPATH（Go 1.16+ 用户特别注意）
GoLand 不强制依赖 GOPATH，但会读取它影响代码索引和 vendor 模式行为。如果你用的是 Go 1.16+ 且启用 Go Modules（几乎所有人都是），GOPATH 只需存在、无需参与构建流程。
- 在
Settings > Go > GOROOT中指定已安装的 Go 路径（如/usr/local/go或C:\Go），不要用包管理器装的“假路径”（比如通过asdf或gvm安装后未刷新 shell 环境，GoLand 就可能找不到） -
Settings > Go > GOPATH建议只填一个路径（如$HOME/go），即使你不放代码进去——否则 GoLand 的代码补全和跳转会降级为纯文件扫描 - 禁用
Use GOPATH that is defined in system environment复选框，避免被终端里残留的旧GOPATH干扰
为什么 go mod download 成功但 GoLand 还标红？检查代理和模块模式
GoLand 的模块解析是独立于终端执行的：它用自己的 go 进程调用 go list -mod=readonly -f...，若环境变量（尤其是 GOPROXY）没传进去，就会卡在“找不到依赖”。
- 在
Settings > Go > Go Modules中，勾选Enable Go modules integration（必须） - 手动填写
GOPROXY，例如https://goproxy.cn,direct或https://proxy.golang.org,direct；不要依赖系统环境变量，GoLand 默认不继承它们 - 确认项目根目录下有
go.mod文件，且go version输出 ≥ 1.12——否则 GoLand 会 fallback 到 GOPATH 模式，导致模块依赖不识别
调试时断点不生效？重点看 dlv 版本和启动配置
GoLand 调试底层依赖 dlv（Delve），但默认下载的版本可能不兼容你的 Go 版本，或未启用源码级调试支持。
- 在
Settings > Go > Debugger > Delve中，选择Use built-in delve（推荐）；如果选了Custom delve，请确保dlv是从源码编译的（go install github.com/go-delve/delve/cmd/dlv@latest），而非用apt/choco安装的老旧包 - 运行配置中，
Run kind必须选Package（不是File），且Package path填./...或具体入口包（如main），否则 dlv 启动时无法定位主模块 - Windows 用户若用 WSL2 开发，请勿在 GoLand 中直接调试 WSL 路径下的代码——dlv 无法映射 Windows 主机路径到 WSL 内部，断点必然失效
最常被忽略的是：GoLand 的 Settings 分为“Project”和“Default Settings”两个层级，新建项目时它用的是 Default 配置；改完设置后记得点右上角 Copy settings to new projects，否则下一个项目又得重配。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
