Published on

Github Release with Git Tag

Authors
  • avatar
    Name
    Shelton Ma
    Twitter

1. 手动命令行方式(适合普通流程)

  1. 打 tag:

    git tag v0.5.0
    git push origin v0.5.0
    
  2. 创建 GitHub Release, 打完 tag 后,进入 GitHub 仓库 → Releases 页面,点击 "Draft a new release",选择刚才的 tag(v0.5.0),填写 changelog,点击发布即可。

2. 自动发布 Release(适合自动化/CI)

使用 GitHub Actions 自动在合并主分支或推送 tag 后发布:

  1. 创建 .github/workflows/release.yml

    name: Release
    
    on:
      push:
        tags:
          - 'v*' # 监听 v 开头的 tag,如 v0.5.0
    
    jobs:
      release:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v4
    
          - name: Create GitHub Release
            uses: softprops/action-gh-release@v2
            with:
              generate_release_notes: true
            env:
              GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    
  2. 推送 tag 后自动触发

    git tag v0.5.0
    git push origin v0.5.0
    

该流程会自动生成 GitHub Release,并带上自动生成的 Release Notes