怎么合并json文件内容

如何高效合并多个JSON文件内容

在数据处理、接口开发或日志分析等场景中，我们常常需要将多个JSON文件的内容合并为一个完整的JSON文件，无论是简单的键值对叠加，还是复杂嵌套结构的整合，正确的合并方法能大幅提升工作效率，本文将从JSON文件的基本结构出发，介绍不同场景下的合并方法，包括手动处理、代码实现（Python、JavaScript）及工具辅助，并提供注意事项和最佳实践。

明确JSON合并需求：合并类型与场景

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，以键值对（对象）或有序列表（数组）为核心结构，合并JSON文件前，需先明确文件的数据结构类型，常见的合并场景分为三类：

合并多个JSON对象文件（键值对叠加）

每个JSON文件是一个独立的对象（如{"name": "A", "age": 20}和{"city": "Beijing", "job": "engineer"}），合并后需要将所有键值对整合到一个对象中，结果为{"name": "A", "age": 20, "city": "Beijing", "job": "engineer"}。
适用场景：配置文件合并、用户信息聚合等。

合并多个JSON数组文件（列表拼接）

每个JSON文件是一个数组（如[{"id": 1}, {"id": 2}]和[{"id": 3}, {"id": 4}]），合并后需要将数组合并为一个长数组，结果为[{"id": 1}, {"id": 2}, {"id": 3}, {"id": 4}]。
适用场景：日志数据汇总、API接口数据聚合等。

合并嵌套结构的JSON文件（深度递归合并）

JSON文件包含多层嵌套对象或数组（如{"user": {"name": "A"}, "scores": [90, 85]}和{"user": {"age": 25}, "scores": [95]}），合并时需递归处理嵌套层：若同一键为对象，则继续合并其子键；若为数组，可选择拼接或覆盖。
适用场景：复杂业务数据整合（如用户画像、订单详情）。

合并JSON文件的常见方法

根据数据量、复杂度和操作习惯，可选择手动处理、代码实现或工具辅助三种方式。

方法1：手动处理（仅适用于极小文件）

若JSON文件内容简单（仅1-2个键值对或少量数组元素），可直接用文本编辑器打开文件，复制粘贴后手动调整格式。

示例：
文件1：{"name": "Alice", "age": 30}
文件2：{"city": "Shanghai", "hobbies": ["reading", "running"]}
手动合并后：{"name": "Alice", "age": 30, "city": "Shanghai", "hobbies": ["reading", "running"]}

缺点：效率低、易出错，仅适用于临时、极小数据量的场景。

方法2：代码实现（推荐，灵活高效）

对于大量文件或复杂结构,通过编程语言实现合并是最可靠的方式，以下是Python和JavaScript的常用代码示例。

（1）Python实现：`json`模块 + 文件操作

Python内置json模块可轻松解析和生成JSON文件，结合os模块遍历文件，支持上述三种合并场景。

场景1：合并多个JSON对象文件（键值对叠加）

假设多个JSON文件位于./data/目录下，每个文件是一个对象，合并为一个对象：

import json
import os
def merge_json_objects(input_dir, output_file):
    merged_data = {}
    for filename in os.listdir(input_dir):
        if filename.endswith(".json"):
            file_path = os.path.join(input_dir, filename)
            with open(file_path, 'r', encoding='utf-8') as f:
                data = json.load(f)
                merged_data.update(data)  # 合并键值对
    with open(output_file, 'w', encoding='utf-8') as f:
        json.dump(merged_data, f, ensure_ascii=False, indent=4)
    print(f"合并完成，结果已保存至 {output_file}")
# 使用示例
merge_json_objects("./data/", "./merged_objects.json")

场景2：合并多个JSON数组文件（列表拼接）

若每个文件是数组,需将所有数组合并为一个数组：

import json
import os
def merge_json_arrays(input_dir, output_file):
    merged_list = []
    for filename in os.listdir(input_dir):
        if filename.endswith(".json"):
            file_path = os.path.join(input_dir, filename)
            with open(file_path, 'r', encoding='utf-8') as f:
                data = json.load(f)
                if isinstance(data, list):  # 确保是数组
                    merged_list.extend(data)
    with open(output_file, 'w', encoding='utf-8') as f:
        json.dump(merged_list, f, ensure_ascii=False, indent=4)
    print(f"合并完成，结果已保存至 {output_file}")
# 使用示例
merge_json_arrays("./data/", "./merged_arrays.json")

场景3：合并嵌套结构的JSON文件（深度递归合并）

使用deepmerge库实现递归合并（需先安装：pip install deepmerge）：

import json
import os
from deepmerge import always_merger
def merge_json_nested(input_dir, output_file):
    merged_data = {}
    for filename in os.listdir(input_dir):
        if filename.endswith(".json"):
            file_path = os.path.join(input_dir, filename)
            with open(file_path, 'r', encoding='utf-8') as f:
                data = json.load(f)
                merged_data = always_merger.merge(merged_data, data)  # 递归合并
    with open(output_file, 'w', encoding='utf-8') as f:
        json.dump(merged_data, f, ensure_ascii=False, indent=4)
    print(f"合并完成，结果已保存至 {output_file}")
# 使用示例
merge_json_nested("./data/", "./merged_nested.json")

（2）JavaScript（Node.js）实现：`fs`模块 + 递归合并

Node.js环境下，可通过fs模块读写文件，结合递归函数处理嵌套结构。

场景1：合并多个JSON对象文件

const fs = require('fs');
const path = require('path');
function mergeJsonObjects(inputDir, outputFile) {
    const mergedData = {};
    const files = fs.readdirSync(inputDir);
    files.forEach(file => {
        if (file.endsWith('.json')) {
            const filePath = path.join(inputDir, file);
            const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
            Object.assign(mergedData, data); // 合并键值对
        }
    });
    fs.writeFileSync(outputFile, JSON.stringify(mergedData, null, 4), 'utf8');
    console.log(`合并完成，结果已保存至 ${outputFile}`);
}
// 使用示例
mergeJsonObjects('./data/', './merged_objects.json');

场景2：合并嵌套结构JSON文件（递归合并）

const fs = require('fs');
const path = require('path');
function deepMerge(target, source) {
    for (const key in source) {
        if (source[key] instanceof Object && key in target) {
            deepMerge(target[key], source[key]); // 递归合并嵌套对象
        } else {
            target[key] = source[key]; // 直接赋值
        }
    }
    return target;
}
function mergeJsonNested(inputDir, outputFile) {
    let mergedData = {};
    const files = fs.readdirSync(inputDir);
    files.forEach(file => {
        if (file.endsWith('.json')) {
            const filePath = path.join(inputDir, file);
            const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
            mergedData = deepMerge(mergedData, data);
        }
    });
    fs.writeFileSync(outputFile, JSON.stringify(mergedData, null, 4), 'utf8');
    console.log(`合并完成，结果已保存至 ${outputFile}`);
}
// 使用示例
mergeJsonNested('./data/', './merged_nested.json');