用途:该资料汇总 Go 语言惯用模式与最佳实践,用于在新写代码、代码评审、重构以及设计包或模块时参考,目标是让 Go 代码简单、一致、可预测。
主要能力:包含核心原则(简单与清晰、使零值有用、接受接口返回结构体)、错误处理(用 %w 包装带上下文错误、自定义错误类型、哨兵错误、errors.Is 与 errors.As、不忽略错误)、并发模式(工作池、context 取消与超时、优雅停机、errgroup 协调、避免协程泄漏)、接口设计(小而专注的接口、在使用处定义接口、类型断言支持可选行为)、包组织(标准项目布局、包命名、避免包级状态)、结构体设计(函数式选项、嵌入组合)、内存与性能(预分配切片、sync.Pool、strings.Builder 避免循环拼接)、工具链集成与常见反模式。
使用方式:按需查阅对应模式;工具命令保持原样:go build ./...、go run ./cmd/myapp、go test ./...、go test -race ./...、go vet ./...、staticcheck ./...、golangci-lint run、go mod tidy、gofmt -w .、goimports -w .。
适用场景:Go 项目开发、代码评审、重构与包/模块设计。
限制:本文档为模式与约定参考,未提供具体安装步骤、版本要求、收费或效果数据,相关信息暂未提供。