语义化版本管理的核心是使版本号变化与代码变更语义严格对齐，依据semver规则：major表示破坏兼容性变更，minor表示新增兼容功能，patch表示仅修复bug；通过semantic-release等工具解析conventional commits自动推导并发布版本，需配套提交规范、分支保护、令牌配置及changelog同步。
自动化构建版本管理的核心，是让版本号变化与代码变更的语义严格对齐，而不是靠人工判断或随意递增。Semantic Versioning（SemVer）提供了一套清晰、可执行的规则，配合自动化工具，就能实现从提交到发布全程可控、可追溯、零误判。
语义化版本号怎么定：MAJOR.MINOR.PATCH 不是编号，是承诺
每个字段代表一类兼容性承诺，不是“功能多就加1”：
- MAJOR：出现任何破坏向后兼容的变更时升级，比如删除公开 API、更改函数签名、移除配置项。升级后下游项目大概率需修改代码才能继续使用。
- MINOR：新增向后兼容的功能，比如加新方法、扩展配置选项、增加只读字段。旧代码无需改动即可运行，新功能可选使用。
- PATCH：仅修复 bug、优化性能、更新文档或依赖，不改变任何公开行为。用户可无感升级。
例如 node-cron 的 4.0.0 版本因移除 Node.js v16 支持并重命名 job.running → job.isActive，属于明确的 Breaking Change，必须升主版本；而 4.3.0 新增 isCronTimeValid 函数，属于安全新增，升次版本。
自动化怎么落地：semantic-release 是主流选择
它不靠人写版本号，而是通过解析 Git 提交信息（如 feat:、fix:、chore:）自动推导应发哪个版本：
- 含
feat:的常规提交 → 触发 MINOR 升级（如 1.2.3 → 1.3.0） - 含
fix:的常规提交 → 触发 PATCH 升级（如 1.2.3 → 1.2.4） - 提交中带
!或BREAKING CHANGE:→ 强制触发 MAJOR 升级（如 1.2.3 → 2.0.0） - 预发布分支（如
beta）上还可自动打-beta.1、-rc.2标签
配置通常在 package.json 的 "release" 字段中定义，搭配插件如 @semantic-release/changelog（生成 CHANGELOG.md）、@semantic-release/git（提交版本变更）、@semantic-release/npm（发布到 npm）。
关键配套动作不能少
光有 semantic-release 不够，还需几个基础保障：
-
统一提交规范：团队必须约定并遵守 Conventional Commits（如
feat(auth): add OAuth2 support），否则工具无法识别意图。 -
保护主干分支：设置 GitHub/GitLab 保护规则，禁止直接 push 到
main，所有变更必须经 PR + CI 检查（包括测试、lint、类型检查）后合并。 -
环境令牌就位：CI 环境需配置对应平台的访问令牌（如
GITHUB_TOKEN、NPM_TOKEN），用于创建 release、打 tag、发布包。 - CHANGELOG 和 package.json 同步更新：semantic-release 默认会自动更新这些文件并提交回仓库，确保源码中的版本号始终与发布状态一致。
其他场景的适配方式
不是所有项目都用 npm 或 JavaScript：
-
Bit 组件库：用
bit tag --minor或--major手动触发语义化打标，支持快照（snap）与正式标签分离。 -
Leiningen（Clojure）：用
lein change version leiningen.release/bump-version minor命令升级，配合:release-tasks自动完成测试、打 tag、部署全流程。 -
自定义 VERSION 文件：如 try 项目，通过脚本读取
VERSION文件内容，结合提交分析决定是否更新该文件并提交，再触发后续发布步骤。
