goland中启用自动格式化需三步：1. settings → editor → code style → go勾选enable code formatting；2. settings → editor → general → auto import开启add/optimize imports on the fly；3. 确保已安装goimports并配置为格式化工具。
GoLand 里怎么开自动格式化（gofmt + goimports）
默认不启用，写完代码得手动格式化，容易漏掉或忘记。必须主动配置，否则团队协作时格式混乱、go fmt 和 goimports 的效果就白费了。
打开 Settings → Editor → Code Style → Go，勾选 Enable code formatting；再进 Settings → Editor → General → Auto Import，把 Add unambiguous imports on the fly 和 Optimize imports on the fly 都打开。这两项合起来，等于每次敲完 fmt.Println 就自动加 "fmt"，删掉不用的包也即时生效。
- 别只依赖保存时格式化（Save Actions），它可能跳过未保存的临时修改
-
goimports不是标准工具，需确保已安装：go install golang.org/x/tools/cmd/goimports@latest - 如果导入分组乱（比如第三方包混在标准库里），检查
goimports是否生效，而不是仅用gofmt
注释写在哪？什么时候必须写？
GoLand 不会强制你写注释，但没注释的公开符号（func、type、const、var）在生成文档或被别人调用时，就是黑盒。尤其导出函数，没注释 = 别人看不懂怎么用。
规则很明确：所有包级公开符号，只要名字不是一眼能懂的（比如 NewServer、ParseJSON 这类），就必须加注释。GoLand 会用灰色提示提醒你缺注释，但别靠它——它不检查注释内容质量。
-
// Package http provides HTTP client and server implementations.这种包注释必须有，且放在package http上方紧邻位置 - 函数注释第一句要概括用途，用动词开头，比如
// ParseJSON decodes JSON data into v.，不是// This function parses JSON... - 不要给接口方法写注释（如
io.Reader.Read），实现者自己负责文档 - 行内注释慎用，除非解释非常规逻辑，比如
x &= x - 1 // clear lowest set bit
命名和变量声明怎么避免低级错误
GoLand 能高亮命名风格问题，但不会替你判断“是否够描述性”。err、i、v 在局部作用域可以，但一放到函数返回值或包变量里，就得换。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
常见翻车点：用 str 代替 username，用 res 代替 responseBody，或者包名用了 util、common 这种模糊词——GoLand 不报错，但别人 import 时根本猜不出这包干啥。
- 包名必须小写、单数、无下划线，
schema可以，schema_v2或Schema不行 - 导出变量/常量用
CamelCase，内部变量用camelCase，别混用 -
for i := range items没问题，但for i := 0; i 中的 <code>i如果后续被闭包捕获（比如起 goroutine），就会出 bug —— GoLand 会标黄警告，别忽略 - 别用
_忽略 error：json.Unmarshal(data, &v)后不检查 err，GoLand 不拦你，但线上就 panic
错误处理不能只靠 IDE 提示
GoLand 会标出未使用的 err 变量，但它不会告诉你该不该用 panic、该不该包装错误、该不该提前 return。这些全靠人判断。
真实项目里，90% 的错误处理漏洞不是语法错，而是逻辑断层：比如文件读取失败后没清理临时资源，HTTP handler 里只记录日志却没返回 500，或者嵌套调用时丢掉了原始错误上下文。
- 永远用
if err != nil显式检查，别写if err == nil主逻辑缩进太深 - 需要传递上下文时，用
fmt.Errorf("failed to parse config: %w", err)，%w才能保留栈信息 -
defer放在错误检查之后，否则defer f.Close()可能在f是 nil 时 panic - GoLand 的
go vet插件可开启，它会抓到一些典型错误，比如defer参数求值时机不对，但得手动打开
真正卡住人的从来不是 GoLand 功能开关，而是“这段错误到底该返回还是 recover”“这个变量名到底会不会让同事多看三秒才懂”——这些没法靠设置解决，得靠写多了、review 多了、踩坑多了，才形成肌肉记忆。
