release-please

GitHub 发布 PR 与版本自动化

补充说明

release-please 根据 Conventional Commits 维护发布 PR，合并后自动打 tag 和生成 GitHub Release。它用 manifest 文件跟踪每个包的版本。

常用示例

npx release-please release-pr \
  --token="$GITHUB_TOKEN" \
  --repo-url=example/app \
  --target-branch=main
npx release-please github-release \
  --token="$GITHUB_TOKEN" \
  --repo-url=example/app \
  --target-branch=main
npx release-please manifest

GitHub Action：

- uses: googleapis/release-please-action@v4
  with:
    release-type: node
    token: ${{ secrets.GITHUB_TOKEN }}

release-please-config.json：

{
  "release-type": "node",
  "packages": {
    ".": {
      "changelog-path": "CHANGELOG.md"
    }
  }
}

易错点与排错

第一次运行需要一个初始版本；manifest 里没有记录时会从 0.0.0 或配置的初始版本开始。
GITHUB_TOKEN 权限不足时无法创建 PR 或 Release；需要 contents 和 pull-requests 写权限。
提交信息不符合约定时不会产生发布；先检查 commit 前缀和作用域。
合并发布 PR 后才会真正打 tag；只生成 PR 不算发布。
monorepo 要为每个包配置路径和组件名；否则版本会互相覆盖。
自定义 changelog 段落要同步配置；否则分类和显示不符合预期。
预发布（prerelease）和稳定版的分支策略要明确，避免版本号跳跃。
Action 版本和配置 schema 会变化；升级前看 release notes。

release-please

补充说明

常用示例

易错点与排错

相关命令