AI di perangkat — profesional dan privat.

Dokumen

Cara Menggabungkan File JSON Online (dan Apa yang Terjadi Saat Kunci Bentrok)

Gabungkan beberapa file JSON menjadi satu: deep atau shallow merge, empat cara menggabungkan array, dan laporan setiap nilai yang ditimpa. Gratis hingga 5 file.

Diperbarui 8 November 2026Baca 8 menit

Untuk menggabungkan file JSON, tambahkan file ke penggabung JSON sesuai urutan penerapannya, pilih Deep merge atau Shallow merge, tentukan apa yang terjadi pada array, lalu tekan Gabungkan JSON. Hasilnya diunduh sebagai satu file. Urutan adalah aturan untuk konflik: jika dua file mengisi kunci yang sama, file yang lebih belakang menang, dan tab Konflik mencantumkan setiap nilai yang ditimpa beserta nilai lama dan nilai barunya. Paket gratis menerima hingga 5 dokumen, masing-masing 10 MB dan total 30 MB, dan semuanya berjalan di perangkat Anda, bukan di server kami. Bagian selanjutnya menjelaskan pengaturan mana yang cocok untuk pekerjaan apa, karena "menggabungkan" bisa berarti tiga hal yang cukup berbeda tergantung isi file Anda.

Menggabungkan file JSON: tiga pekerjaan yang berbeda

Sebelum memilih pengaturan, lihat kurung paling luar pada file Anda. File yang diawali { adalah objek (kunci bernama); file yang diawali [ adalah array (daftar). Apa yang Anda butuhkan dari penggabungan bergantung pada hal itu, dan pada apakah file-file tersebut menggambarkan hal yang sama atau hal yang berbeda.

File AndaYang Anda inginkanPengaturan
Objek: konfigurasi dasar ditambah file penimpaPenimpa hanya mengubah kunci yang disebutnyaDeep merge, Array: Ganti
Array: beberapa daftar record atau entri logSatu daftar panjang berisi semuanyaArray: Sambung
Array berisi tag atau nilai yang berulangSatu daftar, setiap nilai hanya sekaliArray: Union
Dua ekspor dari record yang sama dengan kolom berbedaSatu record per id dengan semua kolomnyaArray: Gabung berdasarkan kunci, Kolom kunci: id
Objek yang bagian bersarangnya harus diganti utuhBagian yang lebih belakang mengganti bagian sebelumnya sepenuhnyaShallow merge

Alat ini menerima akar JSON apa pun, jadi Anda bisa menggabungkan objek dengan objek, array dengan array, atau campuran keduanya. Jika dua nilai di posisi yang sama berbeda tipe (objek bertemu array, angka bertemu teks), keduanya tidak bisa digabung: nilai yang lebih belakang mengganti yang sebelumnya, dan penggantian itu dicatat sebagai konflik.

Cara menggabungkan file JSON menjadi satu, langkah demi langkah

1

Tambahkan dokumen

Seret hingga lima file .json, .jsonc, .jsonl, atau .ndjson ke alat penggabung JSON, atau tekan Tempel JSON untuk mengetik atau menempelkan dokumen. File dan teks tempelan bisa dicampur.

2

Atur urutannya

Dokumen pertama adalah dasar, dan setiap dokumen berikutnya ditumpuk di atasnya. Gunakan panah pada tiap baris untuk memindahkannya ke atas atau ke bawah, sehingga file yang nilainya harus menang berada paling akhir.

3

Pilih cara objek digabung

Di bagian Objek, Deep merge menggabungkan objek bersarang kunci demi kunci; Shallow merge hanya menggabungkan kunci tingkat atas dan mengganti objek bersarang secara utuh. Deep adalah pilihan bawaan.

4

Pilih cara array digabung

Di bagian Array, pilih Ganti, Sambung, Union, atau Gabung berdasarkan kunci. Untuk Gabung berdasarkan kunci, ketik Kolom kunci yang mengenali sebuah record (bawaannya id). Setel Nilai null ke Abaikan jika null di file yang lebih belakang tidak boleh menghapus nilai.

5

Gabungkan dan periksa

Tekan Gabungkan JSON. Baca tab Konflik untuk melihat apa yang ditimpa, dan tab Masukan untuk kunci ganda atau peringatan presisi yang ditemukan di setiap sumber.

6

Unduh atau salin

Pilih indentasi (Minified, 2 spasi, 4 spasi, atau Tab) dan format (JSON, atau NDJSON jika hasilnya array), lalu tekan Unduh JSON atau Salin.

Deep atau shallow merge, empat strategi array, aturan untuk null, dan laporan konflik, semuanya gratis. Gratis: hingga 5 dokumen, masing-masing 10 MB dan total 30 MB. Pro: hingga 100 dokumen, hanya dibatasi oleh perangkat Anda, plus pengiriman dalam ZIP.

Gabungkan file JSON

Deep merge vs shallow merge

Ambil file dasar {"server": {"host": "localhost", "port": 8080}} dan penimpa {"server": {"port": 9090}}. Dengan Deep merge hasilnya {"server": {"host": "localhost", "port": 9090}}: alat masuk ke dalam server dan hanya mengubah kunci yang disebut penimpa. Dengan Shallow merge hasilnya {"server": {"port": 9090}}: seluruh objek server dari file yang lebih belakang mengganti yang sebelumnya, dan host hilang.

Deep merge cocok untuk konfigurasi berlapis (dasar, lalu produksi, lalu penimpa lokal), untuk file terjemahan yang dibagi antartim, dan untuk data uji di mana tiap kasus hanya mengubah beberapa kolom. Shallow merge tepat jika setiap bagian tingkat atas adalah satu kesatuan dan file yang lebih belakang memang harus memberikan pengganti lengkap, misalnya seluruh blok database untuk lingkungan lain.

Menggabungkan array JSON: ganti, sambung, union, atau berdasarkan kunci

Tidak ada satu cara yang benar untuk menggabungkan dua daftar, jadi alat ini bertanya kepada Anda. Pengaturan ini berlaku di mana pun dua array bertemu: di akar file, dan di jalur bersarang mana pun dalam mode deep (atau di kunci tingkat atas dalam mode shallow).

  • Ganti (bawaan): array yang lebih belakang menang sepenuhnya. [1, 2] dan [3] menghasilkan [3].
  • Sambung: semua item dari kedua array, berurutan, termasuk duplikat. [1, 2] dan [2, 3] menghasilkan [1, 2, 2, 3]. Pakai untuk log, event, dan ekspor record yang tidak tumpang-tindih.
  • Union: kedua array digabung, lalu item yang berulang dibuang. [1, 2] dan [2, 3] menghasilkan [1, 2, 3]. Objek dibandingkan berdasarkan isinya, sehingga {"a":1,"b":2} dan {"b":2,"a":1} dihitung sebagai item yang sama.
  • Gabung berdasarkan kunci: record dengan nilai Kolom kunci yang sama digabung kolom demi kolom; record dengan kunci baru ditambahkan di akhir; item yang bukan objek atau tidak punya kunci itu ditambahkan apa adanya.

Gabung berdasarkan kunci mencocokkan tipe sekaligus nilai. Record dengan "id": 1 dan record dengan "id": "1" adalah record berbeda dan tidak digabung. Jika dua ekspor Anda tidak sepakat apakah id berupa angka atau teks, perbaiki salah satunya dulu, atau hasilnya akan berisi kedua versi berdampingan.

Apa yang terjadi saat kunci bentrok, secara persis

Konflik adalah setiap tempat di mana dokumen yang lebih belakang mengganti sebuah nilai alih-alih menggabungkannya. Berikut aturan lengkap yang diikuti penggabung:

  1. 1Kunci yang hanya ada di satu dokumen disalin apa adanya. Tidak ada yang hilang dan tidak ada yang dilaporkan.
  2. 2Dua objek di jalur yang sama digabung kunci demi kunci (dalam mode shallow, hanya di tingkat atas).
  3. 3Dua array di jalur yang sama mengikuti pengaturan Array.
  4. 4Selain itu, misalnya dua angka berbeda, teks bertemu objek, atau objek bertemu objek dalam Shallow merge, diganti oleh nilai yang lebih belakang dan dicatat sebagai konflik.
  5. 5Dokumen yang lebih belakang yang menulis nilai yang persis sama bukan konflik, jadi laporan hanya menampilkan perubahan nyata.
  6. 6null eksplisit di file yang lebih belakang secara bawaan menimpa, karena null adalah nilai JSON yang sah. Jika Nilai null disetel ke Abaikan, null dilewati dan laporan menghitung berapa null yang diabaikan.

Tab Konflik menampilkan setiap konflik sebagai satu baris: jalurnya (seperti $.server.port), nilai sebelumnya, nilai sekarang, dan dokumen asalnya. 500 konflik pertama dicantumkan lengkap, dan hitungannya terus bertambah setelah itu. Jika tab menyatakan tidak ada yang ditimpa, setiap nilai dari setiap dokumen ada di hasil.

Secara bawaan, urutan kunci mengikuti dokumen dasar, dan kunci yang hanya ada di file berikutnya ditambahkan di akhir, sehingga diff di version control tetap kecil. Pilih Urutan kunci: A-Z jika Anda ingin keluaran yang sama bagaimanapun masukan ditulis.

Masalah yang sering muncul dan cara mengatasinya

Yang Anda lihatPenyebabSolusi
Sebuah baris menampilkan nomor baris dan kolom dengan tanda sisipan di bawahnyaDokumen itu bukan JSON yang validPerbaiki dengan Validator JSON atau Formatter JSON, lalu gabungkan lagi
Pesan bahwa ada komentar sementara masukan ketat sedang aktifOpsi Terima komentar dan koma di akhir dimatikanNyalakan lagi; file konfigurasi seperti tsconfig.json sering berisi komentar
Tab Masukan melaporkan kunci gandaSebuah file berisi kunci yang sama dua kali, dan hanya yang terakhir yang tersisa setelah dibacaPastikan mana yang Anda maksud sebelum memercayai hasil penggabungan
Peringatan angka kehilangan presisiBilangan bulat di atas 9007199254740991, seperti sebagian id database 64-bit, berubah saat dibacaSimpan id seperti itu sebagai teks di file sumber
NDJSON tidak tersediaHasil gabungan berupa objek, sedangkan NDJSON butuh arrayGunakan JSON, atau gabungkan file berupa array
Tanda "Pengaturan berubah"Anda mengubah opsi atau urutan setelah menggabungkanTekan Terapkan ulang
Pemberitahuan pratinjau dipersingkatHasilnya terlalu panjang untuk ditampilkan seluruhnyaTidak ada yang hilang: unduhan berisi hasil lengkap

Batas gratis yang paling sering menghentikan penggabungan adalah total 30 MB, bukan 10 MB per file, karena alat ini menyimpan semua masukan dan hasil gabungan di memori sekaligus. Lima file masing-masing 8 MB, total 40 MB, melewati batas total meskipun setiap file berada di bawah batas per file. Menghapus spasi dengan JSON Minifier terlebih dahulu sering membuat kumpulan file berada di bawah batas tanpa mengubah data apa pun.

Setelah digabung: periksa dan rapikan

Untuk melihat penggabungan dari sisi lain, bandingkan file hasil dengan file dasar di JSON Diff: setiap penambahan dan perubahan akan dicantumkan berdasarkan jalur. Cara membaca laporan itu dijelaskan di cara membandingkan dua file JSON. Jika beberapa alat membuat ulang file hasil gabungan, urutkan kuncinya agar urutannya tetap stabil di setiap proses. Dan jika data Anda sebenarnya ekspor spreadsheet, menggabungkan file CSV menjaganya tetap dalam baris dan kolom.

Pertanyaan umum

Bagaimana cara menggabungkan dua file JSON menjadi satu?

Tambahkan kedua file ke penggabung JSON, dengan file yang nilainya harus menang di urutan kedua, biarkan Deep merge terpilih, lalu tekan Gabungkan JSON. Setelah itu unduh hasilnya. Versi gratis mencakup hingga 5 dokumen, masing-masing 10 MB dan total 30 MB.

Bagaimana cara menggabungkan file JSON berupa array menjadi satu array?

Setel Array ke Sambung sebelum menggabungkan. Pada bawaan, Ganti, array yang lebih belakang menang dan Anda hanya mendapat item dari file terakhir. Pilih Union untuk membuang item berulang, atau Gabung berdasarkan kunci untuk menyatukan record yang punya id sama.

Nilai mana yang menang jika dua file JSON punya kunci yang sama?

Nilai dari dokumen yang lebih belakang di daftar. Jika kedua nilai berupa objek, keduanya digabung (dalam mode deep); jika tidak, nilai yang lebih belakang mengganti yang sebelumnya, dan tab Konflik mencatat jalur, nilai lama, nilai baru, dan dokumen yang menang.

Apa beda deep merge dan shallow merge pada JSON?

Deep merge masuk ke objek bersarang dan hanya mengubah kunci yang disebut file berikutnya. Shallow merge hanya bekerja pada kunci tingkat atas, sehingga objek bersarang dari file yang lebih belakang mengganti objek sebelumnya sepenuhnya, termasuk kunci yang tidak disebutkannya.

Bisakah saya mencegah nilai null menghapus data saat menggabungkan JSON?

Bisa. Setel Nilai null ke Abaikan. Null di file yang lebih belakang lalu dilewati di mana pun nilai sudah ada, dan laporan penggabungan menyebutkan berapa null yang diabaikan. Pada Timpa, pilihan bawaan, null mengganti nilai sebelumnya.

Bisakah saya menggabungkan file JSON yang berisi komentar atau JSON Lines?

Bisa. Dengan Terima komentar dan koma di akhir dinyalakan, yang merupakan bawaan, file berisi komentar // atau /* */ dan koma di akhir dibaca seperti biasa. File NDJSON dan JSON Lines dibaca sebagai array, dan hasil berupa array bisa ditulis kembali sebagai NDJSON.

Baca juga

Lainnya tentang Dokumen →