规范

Git 分支策略与规范

概述选择合适的分支策略与提交规范是规模化协作的关键。本文对比 GitFlow 与 Trunk-Based 两种模型,给出规范与落地建议。分支模型GitFlow:适合版本节奏明确与发布周期较长的团队;`main`/`develop`/`feature`/`release`/`hotfix`。Trunk

API 错误码规范与诊断清单(2025)

API 错误码规范与诊断清单(2025)统一错误码与诊断流程让跨团队协作更高效。一、结构与分类结构:`code`/`message`/`traceId`/`details`。分类:客户端/服务端/依赖错误细分与范围编码。二、诊断与重试诊断清单:必采集字段与上下文、用户影响与复现路径。重试与退避:按错

GraphQL 2025 年 9 月规范更新要点

引言这是自 2021 年以来的首次完整规范更新,聚焦开发者体验与工具生态的可编程性提升。核心更新(已验证)OneOf 输入对象(输入联合):通过 `@oneOf` 指令表达互斥输入,简化入口同时保持类型安全。来源:GraphQL 官方博客 2025 年 9 月版公告;Apollo 博客大会回顾。Sc

API 规范与 OpenAPI 契约治理(2025)

API 规范与 OpenAPI 契约治理(2025)OpenAPI 将接口定义标准化,便于契约测试与文档与 Mock 一体化治理。一、版本与变更版本策略:以语义版本管理契约,破坏性变更需走 MAJOR。弃用流程:标注弃用并给出迁移窗口与指引。二、契约测试与回放契约测试:生成服务端与客户端校验用例,避