Versioning
“Versioning” 涵盖语义化版本(semver)、API versioning(URL/header)、数据库 schema versioning。良好 versioning 让客户端知晓兼容性,并支持并行维护多个版本。
- “Semantic versioning signals breaking changes in the major number.” (语义化版本用主版本号标示破坏性变更。)
- “API versioning via headers keeps URLs stable.” (通过请求头做 API 版本管理可保持 URL 稳定。)
- “Migration tools handle database schema versioning automatically.” (迁移工具自动处理数据库模式版本管理。)
version(版本)+ -ing;version 源自拉丁语 vertere(转、变)。
“version” + “-ing”:进行版本标注与管理的过程。
semver(MAJOR.MINOR.PATCH)是开源生态事实标准;不当 versioning 会导致依赖地狱。
- 固定搭配: “semantic versioning” (语义化版本), “API versioning” (API 版本管理), “versioning strategy” (版本策略)
- 名词: version
- 动词: version(较少用)
给每次变更贴上 version 标签的 ing 过程——versioning。
“Poor API versioning broke mobile clients when the response shape changed silently.” (糟糕的 API 版本管理在响应结构静默变更时击垮了移动客户端。)