Git合并package.json时自动解决版本字段冲突方案咨询

完全懂这种痛点！每次合并分支时被package.json的version字段冲突打断，手动改版本号真的浪费时间。下面分享几个靠谱的自动解决方案，帮你彻底摆脱这个问题：

方法一：Git自定义合并驱动（原生支持，最灵活） #

Git允许你为特定文件配置自定义合并逻辑，我们可以写一个脚本自动比较版本号并选取最高的那个。

步骤1：编写版本解析脚本 #

创建一个resolve-package-version.js脚本（存到项目根目录或者全局路径），用Node.js结合semver包来处理语义化版本比较：

#!/usr/bin/env node
const fs = require('fs');
const semver = require('semver');

// 获取Git传入的三个版本文件：共同祖先、当前分支、目标分支
const baseContent = fs.readFileSync(process.argv[2], 'utf8');
const ourContent = fs.readFileSync(process.argv[3], 'utf8');
const theirContent = fs.readFileSync(process.argv[4], 'utf8');

// 提取版本号
const baseVersion = JSON.parse(baseContent).version;
const ourVersion = JSON.parse(ourContent).version;
const theirVersion = JSON.parse(theirContent).version;

// 选出最高版本
const highestVersion = semver.maxSatisfying([baseVersion, ourVersion, theirVersion], '*');

// 基于当前分支的package.json，替换版本号后输出
const updatedPackage = JSON.parse(ourContent);
updatedPackage.version = highestVersion;
console.log(JSON.stringify(updatedPackage, null, 2));

先全局安装semver依赖：

npm install -g semver

步骤2：配置Git合并规则 #

1. 在项目根目录创建.gitattributes文件，添加：

package.json merge=package-version-merge

告诉Git，处理package.json时用我们自定义的合并驱动。

2. 配置Git的合并驱动：

# 全局配置（所有项目生效）
git config --global merge.package-version-merge.driver "node /path/to/resolve-package-version.js %O %A %B"
git config --global merge.package-version-merge.name "Auto-resolve package.json version conflicts by picking highest semver"

# 或者项目本地配置（仅当前项目生效）
git config --local merge.package-version-merge.driver "node ./resolve-package-version.js %O %A %B"
git config --local merge.package-version-merge.name "Auto-resolve package.json version conflicts by picking highest semver"

参数说明：%O是共同祖先版本的文件路径，%A是当前分支的文件，%B是要合并的目标分支文件。

方法二：使用现成的npm包（更简单） #

如果不想自己写脚本，可以用现成的工具包，比如git-merge-package，它已经封装好了版本合并逻辑：

1. 全局安装工具：

npm install -g git-merge-package

2. 配置Git和.gitattributes：

git config --global merge.package-merge.driver "git-merge-package %O %A %B"
echo "package.json merge=package-merge" >> .gitattributes

这样之后合并时，工具会自动处理version字段的冲突，选取最高版本。

方法三：在CI/CD中自动处理（团队协作友好） #

如果团队成员不想修改本地Git配置，可以在PR合并阶段用CI自动处理版本冲突。比如用GitHub Actions写一个工作流：

name: Resolve Package Version Conflict
on: [pull_request]

jobs:
  fix-version-conflict:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: Install dependencies
        run: npm install -g semver jq
      - name: Fetch versions from branches
        id: get-versions
        run: |
          base_version=$(git show ${{ github.base_ref }}:package.json | jq -r '.version')
          head_version=$(git show ${{ github.head_ref }}:package.json | jq -r '.version')
          highest_version=$(semver max $base_version $head_version)
          echo "highest_version=$highest_version" >> $GITHUB_OUTPUT
      - name: Update package.json to highest version
        run: |
          jq --arg ver "${{ steps.get-versions.outputs.highest_version }}" '.version = $ver' package.json > temp.json
          mv temp.json package.json
      - name: Commit and push changes
        run: |
          git config user.name "GitHub Actions Bot"
          git config user.email "actions-bot@github.com"
          git add package.json
          git commit -m "Resolve version conflict: use ${{ steps.get-versions.outputs.highest_version }}"
          git push

这个工作流会在PR打开时自动比较base分支和head分支的版本号，把package.json更新到最高版本并提交，无需手动操作。

注意事项 #

• 确保团队使用语义化版本（semver），否则版本比较逻辑可能出错。如果用非标准版本号，需要调整脚本里的比较规则。
• 自定义合并驱动需要团队成员都配置好，否则只有配置的人能自动解决冲突。
• 这些方案仅处理version字段的冲突，如果package.json还有其他字段冲突，仍然需要手动解决。

内容的提问来源于stack exchange，提问作者Guy