拆分大型JSON文件：公共与环境配置分离及合并方案咨询

完全可以实现你的需求——原生JSON本身不支持文件引用，但通过预构建脚本、JSON扩展语法或者配置工具，就能把公共配置和各环境专属配置拆分维护，再合并还原成完整结构。以下是几种实用方案：

方案1：Node.js脚本手动合并（零额外依赖，灵活可控） #

先按功能拆分文件：

• common.json：仅存放commonA、commonB这类公共配置
• dev.json/stage.json/local.json/prod.json：分别对应各环境的专属配置

然后写一个简单的合并脚本（比如merge-config.js）：

const fs = require('fs');

// 读取公共配置
const common = JSON.parse(fs.readFileSync('./common.json', 'utf8'));

// 定义需要处理的环境列表
const environments = ['dev', 'stage', 'local', 'prod'];

// 合并生成完整配置
const fullConfig = {};
environments.forEach(env => {
  const envSpecific = JSON.parse(fs.readFileSync(`./${env}.json`, 'utf8'));
  // 用展开语法合并，环境专属配置会覆盖公共配置中重复的字段
  fullConfig[env] = { ...common, ...envSpecific };
});

// 写入格式化后的完整JSON文件
fs.writeFileSync('./full-config.json', JSON.stringify(fullConfig, null, 2));

运行node merge-config.js就能生成带缩进、可读性强的完整JSON文件。

方案2：用JSON5扩展语法（支持导入，更贴近原生JSON写法） #

JSON5是JSON的超集，支持注释、导入等语法，需要依赖json5包实现解析合并：

1. 安装依赖：npm install json5 --save-dev
2. 拆分配置文件：
   • common.json5：公共配置
   • dev.json5：通过导入公共配置并添加专属内容，示例：

     {
       ...require('./common.json5'),
       "devOnlyKey": "dev-specific-value"
     }
     

3. 写转换脚本：

   const JSON5 = require('json5');
   const fs = require('fs');
   
   // 读取并解析JSON5文件
   const devConfig = JSON5.parse(fs.readFileSync('./dev.json5', 'utf8'));
   // 转换为标准JSON并保存
   fs.writeFileSync('./dev-full.json', JSON.stringify(devConfig, null, 2));
   

方案3：前端构建工具集成（适合项目环境配置） #

如果你的配置是用于前端项目，webpack、vite等工具本身支持环境配置拆分：

• 把公共配置放在config/common.js：

  module.exports = {
    commonA: 'shared-value',
    commonB: 'shared-other'
  };
  

• 各环境配置继承公共配置，比如config/dev.js：

  const common = require('./common');
  module.exports = {
    ...common,
    apiBaseUrl: 'https://dev.example.com'
  };
  

构建时通过环境变量（比如NODE_ENV=dev）指定加载对应的配置文件，最终可以直接在代码中使用，或者通过插件输出为JSON文件。

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