版本号 `x.y.z`

版本号 x.y.z 中的每个数字,英文到底怎么说?

在日常开发、技术文档或团队沟通中,我们经常碰到类似 1.2.3v2.5.1 这样的版本号。你是否曾犹豫过:这三个位置的数字,究竟该怎么用英语准确称呼?是直接读数字,还是有专门的术语?

本文从语义化版本规范出发,为你彻底讲清楚。


一、标准术语(最重要)

根据 语义化版本(Semantic Versioning,简称 SemVer) 的官方规范,版本号 x.y.z 中的三个位置分别对应:

位置 英文术语 中文译名 典型含义
x Major 主版本号 不兼容的 API 重大变更
y Minor 次版本号 向下兼容的新功能
z Patch 补丁版本号 向下兼容的问题修复

因此,当你需要向外国同事解释版本策略时,最规范的说法是:

“We increment the major version for breaking changes, the minor version for new features, and the patch version for bug fixes.”


二、实际场景中的读法

1. 书面/代码中的读法(字母本身)

如果你要单独提到字母 xyz 的读音(比如口头拼写),则是:

  • x → 读作 /eks/(字母名)
  • y → 读作 /waɪ/(字母名)
  • z → 英式读作 /zed/,美式读作 /ziː/(字母名)

但在版本号上下文中,极少会单独念字母,除非在说“通配符版本”时(如 ^1.2.x 读作 “caret one dot two dot ex”)。

2. 具体版本号的读法(如 1.2.3

当你需要口头读出 1.2.3 这样具体的版本号时,通常直接读数字,中间的 . 读作 dot

“one dot two dot three”

也可以更正式地读作:

“version one point two point three”

(英式英语中常用 point,美式口语中 dot 也很常见)


三、其他常见别名

在某些特定领域或团队习惯中,z 位置也可能被称为:

  • Build(构建号)——常见于 CI/CD 流水线中自动递增的编号。
  • Hotfix(热修复号)——用于紧急修补版本。
  • Revision(修订号)——在 SVN 或早期版本管理中使用。

最通用、最官方的仍然是 Patch


四、容易混淆的点(避坑指南)

  1. 不要把 MajorMinor 搞反
    新手偶尔会误把 Minor 当作主版本,记住:Major = 大(重大变更)Minor = 小(小功能)

  2. Patch 不是 Patch 的动词
    这里的 Patch 是名词,指“补丁包”,而非“打补丁”的动作。

  3. 版本号前缀
    有时前面会有 v,如 v1.2.3,读作 “vee one dot two dot three”,但 v 并不影响 x.y.z 的术语。


五、扩展:预发布版本与构建元数据

语义化版本还允许附加预发布标识和构建元数据,格式如 1.2.3-alpha.1+build.20260710

  • -alpha.1 部分称为 pre-release(预发布版本)
  • +build.20260710 部分称为 build metadata(构建元数据)

但即使加上这些后缀,x.y.z 的核心术语依然不变


六、小结(速记卡片)

  • xMajor(主)
  • yMinor(次)
  • zPatch(补)

读版本号时,直接把数字逐个读出,中间用 dotpoint 连接即可。

掌握这些术语,无论是在英语技术会议、代码评审还是撰写文档时,你都能更准确、自信地表达版本信息。下次当同事问起 2.4.1 的含义,你就可以脱口而出:“Major two, minor four, patch one” 了。


参考标准:语义化版本规范 2.0.0 – https://semver.org