Penukar JSON ke CSV
Tukar JSON kepada CSV dalam pelayar anda, tanpa muat naik dan tanpa pendaftaran.
Semuanya diproses dalam pelayar anda. Apa yang anda tampal tidak dimuat naik atau disimpan.
Panduan terperinci
JSON ke CSV: lajur, nilai bersarang, petikan dan keselamatan formula
Cara penukar membina jadual daripada tatasusunan objek: kesatuan lajur dan susunan, nilai bersarang sebagai teks JSON, petikan, hujung baris LF, apa yang ditolak, dan risiko formula hamparan yang tidak dilindunginya.
Angka utama sepintas lalu
- Input diterima
- Tatasusunan objek, atau satu objek
- Skalar, tatasusunan skalar, tatasusunan tatasusunan dan tatasusunan yang mengandungi null ditolak.
- Lajur
- Kesatuan semua kunci, mengikut tertib pertama kali dilihat
- Rekod yang tiada kunci meninggalkan sel itu kosong.
- Nilai bersarang
- Ditulis sebagai teks JSON padat dalam satu sel
- Objek dan tatasusunan tidak diratakan menjadi lajur tambahan.
- Hujung baris
- LF, tanpa baris baharu akhir
- RFC 4180 menentukan CRLF; kebanyakan alat membaca LF dengan baik.
- Sumber: IETF — RFC 4180
Apa yang masuk, apa yang keluar
Tampal JSON dan kotak kanan menunjukkan CSV, dikemas kini semasa anda menaip. Pautan Muat turun (converted.csv) muncul apabila ada output. Tiada apa dimuat naik.
Input mestilah tatasusunan objek, atau satu objek (dianggap jadual satu baris). Baris pertama output ialah pengepala. Contoh: [{"name":"Mei","city":"Singapore","age":30},{"name":"Ali","city":"Johor","age":25}] memberi
name,city,age
Mei,Singapore,30
Ali,Johor,25
Selain itu, seperti 5, "text", null, [1,2], [[1,2]] atau [{"a":1},null], akan berhenti dengan "Hanya tatasusunan objek (atau satu objek) boleh menjadi jadual. Tatasusunan bersarang tiada baris dan lajur untuk dipetakan." Tatasusunan kosong [] memberi output kosong.
Lajur dan kunci yang tiada
Pengepala ialah kesatuan semua kunci merentas semua rekod, mengikut tertib setiap kunci mula-mula dilihat. Rekod yang tiada kunci mendapat sel kosong:
| Input | Output |
|---|---|
[{"a":1,"b":2},{"b":3,"c":4}] |
a,b,c / 1,2, / ,3,4 |
[{"b":1,"2":2,"1":3}] |
1,2,b / 3,2,1 (kunci seperti integer didahulukan) |
Oleh sebab JavaScript meletakkan kunci seperti integer dahulu, rekod seperti {"b":1,"2":2,"1":3} dibaca sebagai 1, 2, b, tanpa mengira susunannya dalam teks. {} atau [{}] hanya menghasilkan satu pemisah baris.
Nilai sel
| Nilai JSON | Sel |
|---|---|
| rentetan | teks itu sendiri |
| nombor | cetakan JavaScript: 1.50 menjadi 1.5; 12345678901234567890 menjadi 12345678901234567000; 1e21 menjadi 1e+21; -0 menjadi 0 |
true / false |
true / false |
null |
sel kosong (tidak dapat dibezakan daripada "") |
| objek atau tatasusunan | teks JSON padat, berpetik: [1,2] menjadi "[1,2]", {"k":"v,w"} menjadi "{""k"":""v,w""}" |
Rentetan yang kelihatan seperti nombor ("007") ditulis tanpa sebarang penanda, jadi hamparan mungkin menukarnya menjadi nombor 7 apabila dibuka. Itu kelakuan hamparan, bukan sesuatu yang dapat dicegah oleh fail.
Petikan
Medan dibalut dengan petikan berganda hanya jika ia mengandungi koma, petikan berganda, suap baris atau pemulangan bawa, dan petikan terbenam digandakan, seperti yang dikehendaki RFC 4180. Nama pengepala mengikut peraturan sama: kunci a,b menjadi "a,b". Ruang di awal dan akhir tidak diberi petikan, jadi " pad " ditulis tanpa petikan; RFC 4180 menganggap ruang sebagai sebahagian daripada medan. Teks bukan ASCII (é中🙂) ditulis seadanya, dan fail yang dimuat turun ialah UTF-8 tanpa tanda tertib bait.
Suntikan formula hamparan
Nilai ditulis seperti sedia ada. Sel yang bermula dengan =, +, - atau @ (contohnya =SUM(A1)) ialah formula bagi hamparan, dan OWASP mendokumenkannya sebagai suntikan CSV. Alat ini tidak memberi awalan atau meneutralkan sel sedemikian. Jika data datang daripada pengguna yang tidak dipercayai dan CSV akan dibuka dalam hamparan, bersihkan nilai itu sendiri dahulu (contohnya dengan awalan petikan tunggal), dan ambil perhatian bahawa ini mengubah data.
Petua: Untuk memasukkan data bersarang ke dalam lajur, ratakan sebelum menukar, supaya
{"address":{"city":"SG"}}menjadi{"address_city":"SG"}. Alat JSON ke teks menunjukkan laluan yang boleh anda jadikan nama lajur.
Kesilapan biasa
- Menghantar objek yang nilainya ialah rekod (
{"a":{…},"b":{…}}): ia menjadi satu baris dengan sel teks JSON, bukan satu baris bagi setiap entri. - Menjangka
nulldan""dapat dibezakan. - Membuka CSV dengan sel JSON bersarang dalam hamparan dan menjangka lajur berasingan.
- Menganggap output tepat mengikut RFC 4180: ia menggunakan LF, bukan CRLF.
Alat berkaitan
Tukar semula dengan CSV ke JSON, hasilkan output dipisahkan tab dengan JSON ke TSV, semak input dengan pengesah JSON, atau periksa struktur dalam pemapar JSON.
Soalan lazim
Adakah data saya dimuat naik ke mana-mana?
Tidak. Penukaran berjalan sepenuhnya dalam pelayar anda menggunakan JavaScript. Apa yang anda tampal tidak meninggalkan peranti anda, tidak dilog dan tidak disimpan pada pelayan.
Sebesar mana dokumen yang boleh dikendalikan?
Hadnya ialah memori pelayar anda dan bukan kuota pelayan. Dokumen beberapa megabait ditukar tanpa masalah; fail yang sangat besar mungkin menyebabkan halaman tidak bertindak balas seketika.
Apa yang berlaku kepada data bersarang?
Format yang tiada konsep sarang menyimpan nilai bersarang sebagai rentetan JSON di dalam sel, jadi tiada apa yang dibuang secara senyap dan strukturnya boleh dipulihkan.
Adakah ia mengendalikan petikan dan koma dalam medan?
Ya. Penghuraian mengikut RFC 4180, jadi medan berpetik yang mengandungi koma, petikan berganda yang dilepaskan, dan pemisah baris di dalam medan semuanya dibaca dan ditulis dengan betul.
Sumber rujukan
- IETF — RFC 4180, Common Format and MIME Type for CSV Files — Informational: fields, quoting, line breaks, header.
- IETF — RFC 8259, The JSON Data Interchange Format
- OWASP — CSV Injection — Cells starting with =, +, -, @, tab, CR or LF can be treated as formulas.
Panduan ini menerangkan peraturan yang diterbitkan dalam bahasa mudah. Ia bukan nasihat kewangan, undang-undang atau rasmi — peraturan boleh berubah, jadi sahkan dengan agensi yang dipautkan di atas sebelum membuat keputusan.