GoLand启动报GOROOT错误需手动设置：进入Settings > Go > GOROOT，选择Go安装根目录（如/usr/local/go），非bin子目录；模块未识别需确保go.mod存在且module名与import路径一致；struct字段加json标签须光标置于字段名后Alt+Insert生成；测试文件须为xxx_test.go且函数为func TestXXX(t *testing.T)。
GoLand 启动时就报 GOROOT 未设置或指向错误路径
这是最常卡住新手的第一步：GoLand 找不到 Go 编译器。它不读系统环境变量（哪怕你在终端里 go version 能跑），必须在 IDE 里显式指定。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 打开 Settings > Go > GOROOT，点击右侧文件夹图标，手动选中你本地
go的安装根目录（比如/usr/local/go或C:\Go） - 别填
/usr/local/go/bin—— 这是GOBIN的位置，GOROOT必须到bin的上一级 - 如果用
asdf、gvm或 Homebrew 安装的 Go，路径可能是~/.asdf/installs/golang/1.22.0/go，注意展开~为绝对路径 - 改完后点
Apply，再新建一个main.go测试是否能识别func main()和自动导入
Ctrl+Click 跳转不到自定义包，只提示 Cannot find declaration to go to
不是代码写错了，是 GoLand 没把当前项目识别为 Go Module，或者 go.mod 里声明的模块名和实际 import 路径对不上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认项目根目录有
go.mod文件；没有就执行go mod init example.com/myproject（模块名要和你代码里import的前缀一致） - 检查
go.mod第一行module声明是否和所有import语句开头匹配，比如import "example.com/myproject/utils"就要求module example.com/myproject - GoLand 右下角如果显示
Go Modules灰色，说明没启用；点它 →Enable Go Modules Integration - 删掉项目下的
.idea目录 +go.sum，重新File > Reload project，比单纯刷新更可靠
想快速生成 json 字段标签但 Alt+Insert 没反应
GoLand 默认不给 struct 字段加 json: 标签，需要手动触发「Generate tags」动作，而且得先选中字段名，不能光把光标停在行里。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 把光标放在字段名上（比如
Name，不是string那行末尾），按Alt+Insert（macOS 是Cmd+N）→ 选Generate tags - 首次使用会弹窗让你选 tag 类型，勾上
json，并建议勾选Use snake_case（否则生成json:"Name"而非json:"name"） - 如果字段是嵌套 struct 或指针，生成的
json:"name,omitempty"里omitempty是默认加的，要去 Settings > Go > Code Generation > Struct tags 里关掉 - 别依赖「Auto-insert json tags on struct creation」——它只对新写的字段生效，对已存在字段无效
运行测试时提示 test binary not found 或直接跳过
GoLand 默认用 go test 命令执行，但它会严格检查文件名和函数签名。常见漏掉的点是：测试文件没以 _test.go 结尾，或测试函数没用 Test 开头 + 首字母大写。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 测试文件必须叫
xxx_test.go，不能是test_xxx.go或xxx.test.go - 测试函数必须是
func TestXXX(t *testing.T)形式，XXX首字母必须大写；func testXXX()或func Testxxx()都不会被识别 - 右键点击函数名运行时，确保鼠标焦点在函数名上（不是括号或注释里），否则可能误触整个文件
- 如果用了
build tags（比如//go:build integration），记得在 Run Configuration 里补上-tags=integration
Go module 路径、struct tag 生成逻辑、测试命名规则——这些地方看着小，但一旦错一位，IDE 就彻底“失联”，没人会提醒你哪少了个下划线或大小写。
