如何通过Jenkins自动更新package.json文件的version版本号

完全可以实现自动化，以下是可直接落地的操作方案：

前置准备 #

• 给Jenkins绑定的GitLab凭据开通对应仓库的读写权限，确保Jenkins有权限提交代码回远程仓库
• 配置Jenkins执行用户的Git身份信息，避免提交时报身份未配置的错误

方案一：固定自动升级修订号（适合高频日常迭代） #

每次构建自动升级版本号的第三位（修订号，如1.1.24自动升级为1.1.25），修改后的Jenkinsfile如下：

pipeline {
  agent any
  stages {
    stage('Checkout') {
      steps {
        checkout([$class: 'GitSCM', branches: [[name: 'master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'ID', url: 'https://gitlab.com/company/website.git']]])
        // 配置Git提交身份，可根据实际情况修改
        sh 'git config user.name "jenkins-ci"'
        sh 'git config user.email "jenkins@yourcompany.com"'
        // 拉取最新代码避免冲突
        sh 'git pull origin master'
        // 自动升级修订号，同时生成提交记录
        sh 'npm version patch -m "chore: 自动升级版本号到 %s"'
        // 将版本更新提交回GitLab
        sh 'git push origin master --tags'
      }
    }
    stage('Build') {
      steps {
        sh "pwd"
        sh "npm install"
        sh "npm run build"  
      }
    }
    stage('deploy') {
      steps {
        sh "scp -v -o StrictHostKeyChecking=no -r /var/lib/jenkins/workspace/project/build/* ubuntu@prod:/var/www/project/"
      }
    }       
  }      
}

命令说明 #

• npm version patch 是npm自带的版本管理命令，会自动同步更新package.json和package-lock.json的version字段，无需手动修改文件
• 如果不需要自动打版本tag，将命令改为npm version patch --no-git-tag-version -m "chore: 自动升级版本号到 %s"，同时删除push命令里的--tags参数即可

方案二：构建时选择升级类型（适配不同发版场景） #

如果需要灵活控制升级主版本/次版本/修订号，可以给Jenkins流水线新增一个构建参数：

• 参数类型：选择框（Choice）
• 参数名称：VERSION_TYPE
• 选项：patch、minor、major
  将上面的npm version patch改为npm version ${VERSION_TYPE}即可，每次触发构建时可以手动选择需要升级的版本位：
• patch：升级修订号，如1.1.24 → 1.1.25，适合bug修复类迭代
• minor：升级次版本，如1.1.24 → 1.2.0，适合新增功能类迭代
• major：升级主版本，如1.1.24 → 2.0.0，适合架构重构、不兼容变更类迭代

注意事项 #

• 如果仓库设置了master分支保护，不允许直接提交，可以将自动升级步骤放在合并请求（MR）触发的流水线中，或者单独拉取开发分支提交版本更新后走MR审核流程
• 建议给Jenkins任务开启单构建限制，避免多任务同时并发构建导致版本号冲突

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