go微服务代码规范需通过工具链强制执行：gofmt与goimports配合统一格式，%w包装错误保障追踪链路，接口定义置于调用方包内解耦业务与传输层，http客户端必须设超时防雪崩。
Go微服务项目里，代码规范不是靠人盯，而是靠工具链自动卡死在CI和编辑器里；不执行就过不了构建，比写文档管用十倍。
gofmt + goimports 必须一起用，单用gofmt会埋坑
gofmt只处理缩进、空行、括号位置，但不会管理import语句——它可能留下未使用的包、打乱导入分组顺序，甚至把第三方包插进标准库中间。goimports能自动增删import、按组排序（标准库 / 第三方 / 本地），这才是微服务里多人协作不出错的基础。
- 本地开发：VS Code中配置
"go.formatTool": "goimports"，配合"editor.formatOnSave": true - CI阶段：在
.github/workflows/ci.yml里加检查步骤：goimports -l ./... | grep .，非零退出即失败 - 注意：
goimports默认不格式化vendor/目录，微服务若用vendor需显式排除：goimports -l $(go list -f '{{.Dir}}' ./... | grep -v vendor)
错误包装必须用%w，否则链路追踪失效
微服务依赖分布式追踪（如OpenTelemetry），而错误链是上下文传递的关键载体。不用%w会导致errors.Is、errors.As无法穿透多层调用，下游服务只能看到最外层的字符串错误，丢失原始错误类型和堆栈。
- 正确：
return fmt.Errorf("failed to fetch user: %w", err) - 错误：
return fmt.Errorf("failed to fetch user: %v", err)或return errors.New("failed to fetch user") - CI可加静态检查：
golangci-lint run --enable=errwrap，它会报出所有未用%w包装的fmt.Errorf调用
接口定义必须放在调用方包里，别在RPC层硬塞pb包
Protobuf生成的*pb.User是数据契约，不是业务接口。如果把UserRepository接口定义在pb包或service包里，会导致业务逻辑强耦合于传输层，测试时没法轻松mock，也违背“接口隔离”原则。
- 正确定义位置：
internal/user/repository.go里声明type UserRepository interface { GetUser(ctx context.Context, id int) (*domain.User, error) } - domain.User是纯结构体，不含方法，与
pb.User一一映射但不复用——避免protobuf字段变更污染业务层 - grpc handler里只做转换：
pbUser := &pb.User{Name: user.Name}，绝不让pb.User直接参与业务逻辑
微服务间HTTP客户端必须带超时，且禁用http.DefaultClient
默认HTTP客户端没有设置Timeout，一旦下游服务卡住或网络抖动，请求会无限等待，拖垮整个goroutine池，引发雪崩。这不是风格问题，是线上稳定性红线。
- 必须显式构造：
client := &http.Client{Timeout: 5 * time.Second} - 更稳妥做法：用
context.WithTimeout控制单次请求生命周期：req, _ := http.NewRequestWithContext(ctx, "GET", url, nil) - CI可用
staticcheck检测：golangci-lint run --enable=bodyclose,httpresponse，它会警告未关闭响应体和未设超时的客户端
真正难的不是记住每条规则，而是让每条规则在代码提交前就变成不可绕过的硬约束——工具链没配好，规范就是废纸；一次CI绕过，后面就会有十次人为妥协。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
