Node/Gulp中如何仅替换JSON字符串内的换行为\n？

你的痛点我太懂了——手写JSON时为了可读性在字符串里用实际换行，但这种写法本身不符合JSON规范，全局替换换行又会把JSON结构的换行（比如键值对之间的换行）也改成\n，直接破坏了JSON的结构。下面给你两个靠谱的解决方案：

方案一：用正则精准匹配字符串内部换行（轻量场景） #

我们可以通过自定义Gulp流，用正则匹配JSON中的字符串部分，只替换这些字符串里的实际换行，不会碰结构换行。

首先安装依赖：

npm install through2 --save-dev

然后修改你的Gulp任务：

const gulp = require('gulp');
const through = require('through2');

gulp.task('json', function() {
  return gulp.src(['./content.json'])
    .pipe(through.obj(function(file, enc, cb) {
      if (file.isBuffer()) {
        let content = file.contents.toString(enc);
        // 正则匹配JSON字符串（处理转义引号），仅替换字符串内的换行
        content = content.replace(
          /"(\\?.)*?"/gs,
          (match) => match.replace(/\r?\n/g, '\\n')
        );
        file.contents = Buffer.from(content, enc);
      }
      cb(null, file);
    }))
    .pipe(gulp.dest('./dist')); // 输出到合规JSON的目标目录
});

正则说明 #

/"(\\?.)*?"/gs 这个正则专门匹配JSON中的合法字符串：

• /" 匹配字符串开头的引号
• (\\?.) 处理转义字符（比如\"），确保不会误把转义引号当成字符串结束
• *? 非贪婪匹配，避免跨字符串匹配
• gs 全局+单行模式，让.能匹配换行符，保证整个字符串被捕获

方案二：用JSON5转标准JSON（复杂场景更可靠） #

如果你的手写JSON还有其他“不规范”的写法（比如注释、无引号键），用专门的JSON兼容解析库json5会更省心——它支持JSON不允许的宽松语法，能直接解析你手写的带换行的内容，再转成标准JSON。

首先安装依赖：

npm install json5 --save-dev

修改Gulp任务：

const gulp = require('gulp');
const through = require('through2');
const JSON5 = require('json5');

gulp.task('json', function() {
  return gulp.src(['./content.json'])
    .pipe(through.obj(function(file, enc, cb) {
      if (file.isBuffer()) {
        try {
          // 用JSON5解析宽松格式的内容（支持字符串内换行、注释等）
          const data = JSON5.parse(file.contents.toString(enc));
          // 转成标准JSON，第二个参数控制格式化缩进（这里用2空格）
          const validJson = JSON.stringify(data, null, 2);
          file.contents = Buffer.from(validJson, enc);
        } catch (err) {
          console.error('解析JSON5出错:', err);
        }
      }
      cb(null, file);
    }))
    .pipe(gulp.dest('./dist'));
});

为什么推荐这个方案？ #

自己写正则很容易踩坑（比如字符串里的\\n已经是转义换行，正则可能会重复替换），而JSON5是成熟的库，能处理所有边缘情况，转换后的JSON绝对合规，gulp-data肯定能正常读取。

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