# 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.

- Tool: [Penukar JSON ke CSV](https://toolsg.com/ms/json-to-csv)
- Language: ms (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## Angka utama sepintas lalu

| Perkara | Nilai | Sumber |
| --- | --- | --- |
| 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. | [IETF — RFC 4180](https://www.rfc-editor.org/rfc/rfc4180.html) |

## 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](https://toolsg.com/ms/json-to-text) 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 `null` dan `""` 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](https://toolsg.com/ms/csv-to-json), hasilkan output dipisahkan tab dengan [JSON ke TSV](https://toolsg.com/ms/json-to-tsv), semak input dengan [pengesah JSON](https://toolsg.com/ms/json-validator), atau periksa struktur dalam [pemapar JSON](https://toolsg.com/ms/json-viewer).

## 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](https://www.rfc-editor.org/rfc/rfc4180.html) — Informational: fields, quoting, line breaks, header.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
- [OWASP — CSV Injection](https://community.owasp.org/attacks/CSV_Injection) — Cells starting with =, +, -, @, tab, CR or LF can be treated as formulas.
