如何使用Gulp或Grunt插件递增package.json中的rc版本候选值？

API 探路者

2026-9-27

Gulp 实现 package.json 自定义rc字段自动递增方案

插件相关说明

目前没有专门用于自动递增package.json中自定义rc字段的Gulp插件，但实现这个功能非常简单，无需依赖专用插件，用Node原生API或通用Gulp JSON处理插件都可以快速实现。

方案1：使用Node原生API实现（无需额外插件）

直接通过Node内置的fs和path模块读写package.json即可，代码示例如下：

const gulp = require('gulp');
const fs = require('fs');
const path = require('path');

gulp.task('increment-rc', (done) => {
  // 读取package.json文件
  const pkgPath = path.resolve(__dirname, 'package.json');
  const pkgContent = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
  
  // 处理rc字段：不存在则默认设为1，存在则转数字递增后转回字符串
  const currentRc = Number(pkgContent.rc || 0);
  pkgContent.rc = String(currentRc + 1);
  
  // 写回文件，保留2空格缩进符合JSON规范
  fs.writeFileSync(pkgPath, JSON.stringify(pkgContent, null, 2), 'utf8');
  done();
});

使用时直接执行gulp increment-rc即可自动完成rc字段递增，也可以将该任务串联到你的常规构建流程中，比如：

gulp.task('build', gulp.series('increment-rc', /* 其余构建任务 */));

方案2：使用gulp-json-editor实现

如果你的项目已经引入了gulp-json-editor处理JSON文件，也可以用该插件实现，代码示例如下：

const gulp = require('gulp');
const jsonEditor = require('gulp-json-editor');

gulp.task('increment-rc', () => {
  return gulp.src('./package.json')
    .pipe(jsonEditor((pkg) => {
      const currentRc = Number(pkg.rc || 0);
      pkg.rc = String(currentRc + 1);
      return pkg;
    }))
    .pipe(gulp.dest('./')); // 直接覆盖原package.json
});