standard-version：版本控制、生成 changelog、打 tag

[buddywang]

工具

standard-version

生成 changelog 前提

你的 commit message 符合规范（概括）

安装

# 全局安装
npm i -g standard-version

使用

JS 项目

发布一个版本

运行

standard-version
# 根据最后一个 tag 生成版本（默认更新补丁版本），没有 tag 则生成版本 v1.0.0

上面命令会执行下面的内容：

• 1. 查看 package.json/package-lock.json/bumpfiles 里的版本信息（使用最后一个 git tag）确认当前的版本
• 2. 更新 package.json/package-lock.json/bumpfiles 里的版本信息（默认更新补丁版本）
• 3. 根据你的 commit message 生成/更新 CHANGELOG.md（包含bugfix、feature、breaking change三部分）
• 4. 新增一个提交，用来更新 package.json/package-lock.json/bumpfiles 和 CHANGELOG.md
• 5. 根据版本号打一个 tag

注意：发布版本会新增一个提交，为了避免触发 git hooks，可以在命令后加上 --no-verify 参数

自定义发布版本号

假设现在版本是 v1.0.0，运行 standard-version 命令会默认增加补丁版本，即生成版本 v1.0.1，你可以通过以下命令来自定义版本号：

standard-version --release-as 1.1.0
# 打 tag 时默认在版本号前加 v，更改这个默认值可以运行 `standard-version -t <new-prefix>`

发布一个预发布版本

假设现在版本是 v1.0.0，运行命令：

standard-version --prerelease
# 这会发布一个 v1.0.0-0 的版本

# 也可以为预发布版本起名字
standard-version --prerelease alpha
# 这会发布一个 v1.0.0-alpha.0 的版本

非 JS 项目

• 1. 安装 node.js （包含 npx 命令）
• 2. 全局安装 standard-version，npm i -g standard-version
• 3. 在上面的命令前加上 npx 运行即可

     另外

• 运行 standard-version 只会更改本地仓库的内容，不会影响远程仓库
• semantic-release 比 standard-version 多提供了不仅仅 发布版本后自动 push 到远程仓库的功能