GoLand安装后必须改的三个GOPATH相关设置：一是GOROOT须手动指向本地Go安装路径；二是GOPATH建议设为单路径（如$HOME/go）；三是勾选“Index entire GOPATH”以保障跳转与补全正常。
GoLand 安装后必须改的三个 GOPATH 相关设置
GoLand 默认不继承系统 GOPATH，也不自动识别 go.mod 项目结构，直接新建项目常导致 go run 报错“cannot find package”或模块解析失败。
进 Settings → Go → GOROOT / GOPATH 后需手动确认：
-
GOROOT指向你本地安装的 Go 路径（如/usr/local/go或C:\Go），不能留空或填错版本目录 -
GOPATH建议显式设为单路径（如$HOME/go），避免多个路径用分号/冒号拼接——GoLand 对多路径 GOPATH 解析不稳定 - 勾选 “Index entire GOPATH”，否则代码跳转和自动补全在非当前项目包里会失效
新建项目时选 “Go Modules” 而不是 “Empty Project”
选错模板会导致 go mod init 不触发、go.sum 缺失、依赖无法下载——这是新手最常卡住的点。
正确操作路径：File → New Project → 左侧选 “Go → Go Modules” → 右侧填写 Module path（如 example.com/myapp）→ Create。
立即学习“go语言免费学习笔记（深入）”；
此时 GoLand 会自动生成：
-
go.mod（含module声明和go版本） -
go.sum（首次go get后生成） - 项目 SDK 自动绑定到已配置的 GOROOT
若误选 “Empty Project”，后续需手动在终端执行 go mod init example.com/myapp，且 GoLand 不会自动重载模块索引，得点右上角 Load module 图标刷新。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
运行 main.go 的两种方式及对应陷阱
GoLand 提供图形化运行入口，但底层调用命令不同，行为差异明显：
- 点击右上角绿色三角形 ▶️：默认走
go run main.go，只编译当前文件，**不检查未引用的包是否可构建**，容易掩盖import错误 - 右键
main.go → Run 'main.go'：等价于go run .，会加载整个模块，触发go.mod校验和依赖下载，更接近真实部署流程 - 若提示
command-line-arguments: cannot find module providing package，大概率是当前目录没go.mod或GO111MODULE=off环境变量干扰，检查终端中go env GO111MODULE是否为on
验证环境是否真就绪：三行终端命令足矣
别只信 IDE 绿色按钮，终端才是最终裁判。在项目根目录下依次执行：
go version
确认输出 Go 版本 ≥ 1.16（模块默认启用所需最低版本）
go list -m all
应列出当前模块及所有依赖，无报错即模块解析正常
go build -o myapp .
成功生成可执行文件 myapp（macOS/Linux）或 myapp.exe（Windows），说明编译链路完整
特别注意：go build 不写 -o 时默认输出到 $HOME/go/bin（若 GOPATH/bin 在 PATH 中），容易误以为没生成——建议始终显式指定输出名。
