std-go

基于 Google Golang 代码规范，结合实际工程经验进行了调整和补充。

规范等级定义

| 等级 | 定义 | |------|------| | 必须（Mandatory） | 用户必须采用，代码扫描工具应将其视为错误 | | 推荐（Preferable） | 用户理应采用，但如有特殊情况可以不采用 | | 可选（Optional） | 用户可参考，自行决定是否采用 |

核心规则速查

| 类别 | 必须遵守 | |------|----------| | 格式化 | 使用 gofmt 格式化代码 | | import | 使用 goimports，禁止相对路径导入，标准包在最上 | | 错误处理 | 必须处理 error，error 必须是最后一个返回值 | | panic | 禁止用于一般错误处理，仅用于不变量断言 | | 命名 | 驼峰式，包名小写无下划线，文件名小写下划线分隔 | | 注释 | 导出名字必须有文档注释，格式 // Name 描述 | | switch | 必须有 default 分支 | | goto | 业务代码禁止使用 | | 嵌套 | 深度不超过 4 层 | | 代码行数 | 文件 ≤ 800 行，函数 ≤ 80 行 | | 依赖管理 | 使用 go modules |

完整规范

详见 reference/full-standards.md，包含：

• 代码风格（格式化、换行、括号空格、import）
• 错误处理（error、panic、recover）
• 注释规范（包、结构体、方法、变量、常量、类型）
• 命名规范（包、文件、结构体、接口、变量、常量、函数）
• 控制结构（if、for、range、switch、return、goto）
• 函数规范（参数、defer、接收器、代码行数、嵌套、变量声明、魔法数字）
• 依赖管理和应用服务规范