standard-version

执行命令 → 读取配置 → 分析提交 → 计算版本 → 更新文件 → 生成 CHANGELOG → Git 提交 → 创建标签
    ↓         ↓          ↓          ↓          ↓          ↓              ↓         ↓
 Command   Config     Analyze    Calc Ver   Update     Generate        Commit    Tag

pnpm add standard-version -D

# 可选：commitlint 集成
pnpm add @commitlint/cli @commitlint/config-conventional -D

# 可选：husky 钩子
pnpm add husky -D

# 首次发布
npx standard-version --first-release

# 常规发布
npx standard-version

# 指定版本类型
npx standard-version --release-as major   # 1.0.0 → 2.0.0
npx standard-version --release-as minor   # 1.0.0 → 1.1.0
npx standard-version --release-as patch   # 1.0.0 → 1.0.1

# 预发布
npx standard-version --prerelease alpha   # 1.0.0 → 1.0.1-alpha.0

# 跳过 CHANGELOG 生成
npx standard-version --skip.changelog

# 跳过 Git 提交
npx standard-version --skip.commit

# 跳过 Git 标签
npx standard-version --skip.tag

# 跳过多个步骤
npx standard-version --skip.changelog --skip.tag

module.exports = {
  // 跳过步骤
  skip: {
    changelog: false,  // 不跳过 CHANGELOG 生成
    commit: false,     // 不跳过 Git 提交
    tag: false         // 不跳过 Git 标签
  },

  // 提交信息类型
  types: [
    { type: 'feat', section: '✨ Features' },
    { type: 'fix', section: '🐛 Bug Fixes' },
    { type: 'perf', section: '⚡ Performance' },
    { type: 'refactor', section: '♻️ Code Refactoring' },
    { type: 'docs', section: '📝 Documentation', hidden: true },
    { type: 'style', hidden: true },
    { type: 'chore', hidden: true },
    { type: 'test', hidden: true }
  ],

  // 提交信息格式
  headerFormat: '## {{previousTag}}...{{currentTag}}',
  commitUrlFormat: '{{host}}/{{owner}}/{{repository}}/commit/{{hash}}',
  compareUrlFormat: '{{host}}/{{owner}}/{{repository}}/compare/{{previousTag}}...{{currentTag}}',

  // 预发布配置
  prerelease: 'beta'
}

types: [
  { type: 'feat', section: '✨ Features', hidden: false },
  { type: 'fix', section: '🐛 Bug Fixes', hidden: false },
  { type: 'perf', section: '⚡ Performance Improvements', hidden: false },
  { type: 'refactor', section: '♻️ Code Refactoring', hidden: false },
  { type: 'docs', section: '📝 Documentation', hidden: true },
  { type: 'style', section: '💄 Styles', hidden: true },
  { type: 'chore', section: '🎫 Chores', hidden: true },
  { type: 'test', section: '✅ Tests', hidden: true },
  { type: 'build', section: '📦 Build System', hidden: true },
  { type: 'ci', section: '👷 CI', hidden: true }
]

{
  "scripts": {
    "release": "standard-version",
    "release:alpha": "standard-version --prerelease alpha",
    "release:beta": "standard-version --prerelease beta",
    "release:major": "standard-version --release-as major",
    "release:minor": "standard-version --release-as minor"
  }
}

// 版本计算优先级（从高到低）
1. BREAKING CHANGE → Major
2. feat → Minor
3. fix/perf → Patch
4. refactor/style/docs/test/chore → 不触发版本更新

# 示例 1：多个提交的版本计算
当前版本: 1.0.0
提交记录:
- docs: update README        → 不影响版本
- fix: fix login bug         → Patch 提升
- feat: add user profile     → Minor 提升

最终版本: 1.1.0 (取最高优先级变更)

# 示例 2：破坏性变更
当前版本: 1.2.3
提交记录:
- feat!: remove deprecated API  → Major 提升

最终版本: 2.0.0

# 示例 3：无相关提交
当前版本: 1.0.0
提交记录:
- docs: update docs
- chore: update dependencies

结果: 无版本变更，跳过发布

# 当前版本: 1.0.0
npx standard-version --prerelease alpha
# 结果: 1.0.1-alpha.0

# 再次运行
npx standard-version --prerelease alpha
# 结果: 1.0.1-alpha.1

# 正式发布
npx standard-version
# 结果: 1.0.1

# Changelog

## [1.1.0](https://github.com/user/repo/compare/v1.0.0...v1.1.0) (2024-01-15)

### ✨ Features

* add user authentication ([a1b2c3d](https://github.com/user/repo/commit/a1b2c3d))
* implement dashboard ([e4f5g6h](https://github.com/user/repo/commit/e4f5g6h))

### 🐛 Bug Fixes

* resolve login issue ([i7j8k9l](https://github.com/user/repo/commit/i7j8k9l))

## [1.0.0](https://github.com/user/repo/compare/v0.1.0...v1.0.0) (2024-01-01)

### ⚠ BREAKING CHANGES

* API endpoints have changed

### ✨ Features

* initial release ([m1n2o3p](https://github.com/user/repo/commit/m1n2o3p))

# 1. 开发功能
git add .
git commit -m "feat: add new feature"

# 2. 创建发布
npm run release

# 3. 推送代码和标签
git push --follow-tags origin main

# 4. 发布到 npm
npm publish

name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, 'chore(release)')"
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          fetch-depth: 0
      
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          registry-url: 'https://registry.npmjs.org'
      
      - run: pnpm install
      
      - name: Create Release
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          npx standard-version
          git push --follow-tags origin main
      
      - name: Publish to npm
        run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

// .versionrc.js
module.exports = {
  preset: 'conventionalcommits',
  presetConfig: {
    types: [
      { type: 'feat', section: 'Features' },
      { type: 'fix', section: 'Bug Fixes' },
      { type: 'perf', section: 'Performance' }
    ]
  }
}

npx standard-version --skip.commit --skip.tag

npx standard-version --dry-run

pnpm add @commitlint/cli @commitlint/config-conventional -D

module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [
      2,
      'always',
      ['feat', 'fix', 'perf', 'refactor', 'docs', 'style', 'test', 'chore', 'revert']
    ],
    'subject-case': [0],
    'type-case': [2, 'always', 'lower-case'],
    'type-empty': [2, 'never'],
    'subject-empty': [2, 'never'],
    'header-max-length': [2, 'always', 100]
  }
}

# 初始化 husky
npx husky init

# 添加 commitlint 钩子
echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg

{
  "scripts": {
    "prepare": "husky",
    "release": "standard-version",
    "release:alpha": "standard-version --prerelease alpha",
    "release:beta": "standard-version --prerelease beta",
    "release:major": "standard-version --release-as major",
    "release:minor": "standard-version --release-as minor",
    "release:dry": "standard-version --dry-run"
  }
}

# Changelog

All notable changes to this project will be documented in this file.

{{#each releases}}
  ## [{{title}}]({{href}}) - {{niceDate}}

  {{! Features }}
  {{#if merges}}
  ### ✨ Features

  {{#each merges}}
  - {{message}} ([{{id}}]({{href}}))
  {{/each}}
  {{/if}}

  {{! Bug Fixes }}
  {{#if fixes}}
  ### 🐛 Bug Fixes

  {{#each fixes}}
  - {{commit.subject}} ([{{commit.shortHash}}]({{commit.href}}))
  {{/each}}
  {{/if}}

  {{! Breaking Changes }}
  {{#if breaking}}
  ### ⚠️ Breaking Changes

  {{#each breaking}}
  - {{message}}
  {{/each}}
  {{/if}}

{{/each}}

// .versionrc.js
module.exports = {
  // 指定模板文件
  writerOpts: {
    transform: (commit, context) => {
      // 自定义转换逻辑
      if (commit.type === 'feat') {
        commit.type = '✨ Features'
      } else if (commit.type === 'fix') {
        commit.type = '🐛 Bug Fixes'
      }
      return commit
    }
  }
}

# standard-version 会检测是否有相关提交
# 如果没有 feat/fix 类型的提交，会提示：
# "No relevant changes detected, skipping release."

# 强制发布
npx standard-version --release-as patch

// .versionrc.js
module.exports = {
  // 自定义提交 URL 格式
  commitUrlFormat: 'https://gitee.com/{{owner}}/{{repository}}/commit/{{hash}}',

  // 自定义版本比较 URL
  compareUrlFormat: 'https://gitee.com/{{owner}}/{{repository}}/compare/{{previousTag}}...{{currentTag}}',

  // 自定义 Issue URL
  issueUrlFormat: 'https://gitee.com/{{owner}}/{{repository}}/issues/{{id}}'
}

git commit -m "docs: update README [skip release]"

# 方法 1：命令行参数
npx standard-version --infile docs/CHANGELOG.md

# 方法 2：配置文件
module.exports = {
  infile: 'docs/CHANGELOG.md'
}

# 方法 1：命令行参数
npx standard-version --tag-prefix 'release-'
# 结果: release-1.0.0

# 方法 2：配置文件
module.exports = {
  tagPrefix: 'v'
}

// 根目录 .versionrc.js
module.exports = {
  // 只处理根目录提交
  path: '.',

  // 或指定包目录
  // path: 'packages/core'
}

// 在子包中运行
cd packages/core
npx standard-version

# 启用详细日志
DEBUG=conventional-changelog:* npx standard-version

# 查看具体步骤
npx standard-version --dry-run --verbose

Error: No git remote found

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 或跳过 Git 相关检查
npx standard-version --skip.commit --skip.tag

Error: Cannot find repository URL in package.json

{
  "repository": {
    "type": "git",
    "url": "https://github.com/user/repo.git"
  }
}

Error: Invalid tag format

# 清理错误的标签
git tag -d v1.0.0
git push --delete origin v1.0.0

# 重新创建发布
npx standard-version

No relevant changes detected, skipping release.

# 1. 删除本地标签
git tag -d v1.0.0

# 2. 删除远程标签
git push --delete origin v1.0.0

# 3. 重置提交
git reset --hard HEAD~1

# 4. 强制推送
git push --force origin main

# 5. 重新发布
npx standard-version

#!/bin/bash

# 检查是否在主分支
BRANCH=$(git branch --show-current)
if [ "$BRANCH" != "main" ]; then
  echo "Error: Please switch to main branch"
  exit 1
fi

# 检查是否有未提交的更改
if [ -n "$(git status --porcelain)" ]; then
  echo "Error: Working directory is not clean"
  exit 1
fi

# 拉取最新代码
git pull origin main

# 运行测试
npm test || exit 1

# 创建发布
npx standard-version "$@"

# 推送代码和标签
git push --follow-tags origin main

# 发布到 npm
npm publish

echo "✅ Release completed successfully!"

chmod +x release.sh
./release.sh --release-as minor

# 1. 为每个包创建配置
packages/
  ├── core/
  │   └── .versionrc.js
  ├── cli/
  │   └── .versionrc.js
  └── utils/
      └── .versionrc.js

# 2. 根据包分别发布
cd packages/core && npx standard-version
cd packages/cli && npx standard-version
cd packages/utils && npx standard-version

name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, 'chore(release)')"
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          fetch-depth: 0

      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          registry-url: 'https://registry.npmjs.org'

      - run: pnpm install

      - name: Run tests
        run: npm test

      - name: Create Release
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          npx standard-version
          git push --follow-tags origin main

      - name: Publish to npm
        run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}