semantic-release

基于提交信息自动发布版本

补充说明

semantic-release 根据 Conventional Commits 计算下一个版本号、生成变更日志、打 tag 并发布。它通常在 CI 的发布分支上运行，需要完整的 git 历史和发布令牌。

常用示例

npx semantic-release --dry-run
npx semantic-release --no-ci
CI=true npx semantic-release

.releaserc.json：

{
  "branches": ["main"],
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    "@semantic-release/changelog",
    "@semantic-release/npm",
    "@semantic-release/github",
    ["@semantic-release/git", {
      "assets": ["CHANGELOG.md", "package.json"],
      "message": "chore(release): ${nextRelease.version}"
    }]
  ]
}

易错点与排错

• 浅克隆没有历史，无法计算版本；CI 要设置 fetch-depth: 0。
• 提交信息不符合 Conventional Commits 时可能不产生发布；先检查 feat:/fix:/BREAKING CHANGE。
• --dry-run 仍会读取令牌和配置；不要把 dry-run 当成完全无副作用。
• 发布需要 GITHUB_TOKEN、NPM_TOKEN 等权限；fork PR 默认拿不到。
• 分支配置要和实际发布分支一致；在 main 上配了 master 不会触发。
• 自动改 package.json 和 CHANGELOG.md 会再产生提交；确保 CI 不会因此循环触发。
• monorepo 需要额外的包路径和 tag 格式配置；默认行为按单包设计。
• npm provenance 和私有 registry 的配置不同；发布失败先看 registry 认证。

相关命令

• release-please — GitHub 的发布自动化
• goreleaser — Go 制品发布
• commitlint — 提交信息规范