跳转到内容

Versioning

“Versioning” 涵盖语义化版本(semver)、API versioning(URL/header)、数据库 schema versioning。良好 versioning 让客户端知晓兼容性,并支持并行维护多个版本。

  1. “Semantic versioning signals breaking changes in the major number.” (语义化版本用主版本号标示破坏性变更。)
  2. “API versioning via headers keeps URLs stable.” (通过请求头做 API 版本管理可保持 URL 稳定。)
  3. “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 版本管理在响应结构静默变更时击垮了移动客户端。)