GoReleaser + GitHub Actions 实战：打造自动化的 Go 跨平台发版流水线

# macOS 用户可以直接用 brew
brew install goreleaser/tap/goreleaser

# 其他平台可以使用 go install
go install github.com/goreleaser/goreleaser/v2@latest

version: 2

# 构建前执行的代码检查或依赖拉取
before:
  hooks:
    - go mod tidy

# 核心构建配置
builds:
  - id: mytool
    main: ./cmd/mytool # 入口文件路径
    binary: mytool
    env:
      - CGO_ENABLED=0 # 纯静态编译，避免跨平台依赖问题
    goos:
      - linux
      - darwin
      - windows
    goarch:
      - amd64
      - arm64
    # 编译期通过 ldflags 动态注入版本信息
    ldflags:
      - -s -w
      - -X main.version={{.Version}}
      - -X main.commit={{.Commit}}
      - -X main.date={{.Date}}

# 归档配置
archives:
  - id: default
    format: tar.gz
    name_template: >-
      {{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}
    # Windows 打包为 zip，更符合用户习惯
    format_overrides:
      - goos: windows
        format: zip
    # 随包附带的说明文件
    files:
      - README.md
      - LICENSE

# 生成校验和文件
checksum:
  name_template: 'checksums.txt'

# 自动生成更新日志
changelog:
  sort: asc
  filters:
    exclude:
      - '^docs:'
      - '^test:'
      - Merge pull request
      - Merge branch

goreleaser release --snapshot --clean

name: Release

on:
  push:
    tags:
      - 'v*' # 只要推送以 v 开头的 tag 就触发流水线

permissions:
  contents: write # 必须赋予写入权限，以便创建 GitHub Release

jobs:
  goreleaser:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 必须拉取完整 Git 历史，用于生成准确的 Changelog

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.22'
          cache: true

      - name: Run GoReleaser
        uses: goreleaser/goreleaser-action@v5
        with:
          distribution: goreleaser
          version: latest
          args: release --clean
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # GitHub 自动生成的 Token

git tag -a v1.0.0 -m "feat: release version 1.0.0"
git push origin v1.0.0