# JSON ke TSV: output berpisah tab, petikan dan keserasian

> Cara penukar menulis teks berpisah tab daripada rekod JSON: kesatuan lajur, nilai bersarang, sel mana yang diberi petikan (dan mengapa ini melangkaui takrifan IANA), hujung baris, dan apa yang perlu dilakukan apabila penerima tidak dapat membaca petikan.

- Tool: [Penukar JSON ke TSV](https://toolsg.com/ms/json-to-tsv)
- 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. |  |
| Pembatas | Tab di antara sel, suap baris di antara baris — Tiada baris baharu akhir ditambah. | [IANA — text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) |
| Petikan | Hanya sel yang mengandungi tab, petikan berganda atau pemisah baris — Koma dan ruang tidak pernah mencetuskan petikan. Sel berpetik menggunakan penggandaan " gaya CSV. |  |
| Nilai bersarang | Teks JSON padat dalam satu sel — Oleh sebab teks JSON mengandungi petikan berganda, sel sedemikian diberi petikan. |  |

## Apa yang masuk, apa yang keluar

Tampal JSON dan kotak kanan menunjukkan teks berpisah tab, dikemas kini semasa anda menaip. Pautan Muat turun (`converted.tsv`) muncul apabila ada output; tiada apa dimuat naik. Anda juga boleh menyalin hasil dan menampalnya ke hamparan, yang lazimnya meletakkan setiap nilai berpisah tab dalam selnya sendiri.

Input mestilah tatasusunan objek atau satu objek (satu baris). Baris pertama ialah pengepala. Contoh: `[{"name":"Mei","city":"Singapore","age":30},{"name":"Ali","city":"Johor","age":25}]` memberi yang berikut, di mana `→` mewakili tab:

```
name→city→age
Mei→Singapore→30
Ali→Johor→25
```

Input lain (`5`, `"text"`, `null`, `[1,2]`, `[[1,2]]`, `[{"a":1},null]`) 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 nilai sel

Lajur ialah kesatuan semua kunci mengikut tertib pertama kali dilihat; rekod tanpa kunci mendapat sel kosong (`[{"a":1,"b":2},{"b":3,"c":4}]` memberi pengepala `a→b→c`, kemudian `1→2→` dan `→3→4`). Kunci seperti integer didahulukan, menaik, kerana begitulah JavaScript menyusun kunci objek.

| Nilai JSON | Sel |
| --- | --- |
| rentetan | teks itu |
| nombor | cetakan JavaScript (`1.50` menjadi `1.5`, `12345678901234567890` menjadi `12345678901234567000`) |
| `true` / `false` | `true` / `false` |
| `null` | sel kosong (sama seperti `""`) |
| objek atau tatasusunan | teks JSON padat, contohnya `[1,2]` |

## Petikan: di mana alat ini melangkaui piawaian

Pendaftaran IANA bagi `text/tab-separated-values` menyatakan setiap rekod ialah satu baris, medan dipisahkan oleh tab, dan medan yang mengandungi tab tidak dibenarkan. Ia tidak mempunyai petikan langsung. Alat ini memerlukan cara untuk menulis nilai yang mengandungi tab atau pemisah baris, jadi ia meminjam konvensyen CSV: sel yang mengandungi tab, petikan berganda, suap baris atau pemulangan bawa dibalut dengan petikan berganda, dengan petikan dalaman digandakan. Output yang disahkan:

| Nilai | Sel yang ditulis |
| --- | --- |
| `has<TAB>tab` | `"has<TAB>tab"` |
| `say "hi"` | `"say ""hi"""` |
| `l1<newline>l2` | `"l1<newline>l2"` |
| `a,b` | `a,b` (koma tidak penting dalam TSV) |
| `  pad  ` | `  pad  ` (tanpa petikan) |
| tatasusunan `[1,2]` | `[1,2]` (tiada petikan berganda di dalam, jadi tanpa petikan) |
| objek `{"k":1}` | `"{""k"":1}"` |

Nilai bersarang yang mengandungi rentetan, seperti `["a","b"]`, mengandungi petikan berganda, jadi ia ditulis sebagai `"[""a"",""b""]"`. Pembaca yang tidak memahami petikan akan menunjukkan tanda petikan itu secara literal. Jika penerima anda pembaca TSV gaya IANA yang ketat, ia juga akan keliru dengan sel yang mengandungi tab atau pemisah baris; bersihkan nilai itu dahulu atau gunakan format lain.

Hujung baris ialah LF tanpa baris baharu akhir, dan teks bukan ASCII ditulis seadanya (fail ialah UTF-8 tanpa tanda tertib bait).

## Keselamatan formula

Sel ditulis seperti sedia ada. Nilai yang bermula dengan `=`, `+`, `-` atau `@` boleh dianggap formula apabila teks ditampal ke hamparan (OWASP menggelarnya suntikan CSV dan turut menyenaraikan tab, pemulangan bawa dan suap baris di hadapan). Alat ini tidak meneutralkannya. Jika data tidak dipercayai, bersihkan nilai itu sendiri, dengan menerima bahawa data kemudian berubah.

> **Petua:** Pilih TSV berbanding CSV apabila nilai anda mengandungi banyak koma (alamat, ayat) dan tiada tab. Hampir tiada apa memerlukan petikan, yang memastikan output mudah dibaca dan pemisah mudah terus berfungsi.

## Kesilapan biasa

- Menjangka `\t` yang ditulis dalam rentetan muncul sebagai escape; tab sebenar dalam nilai mencetuskan petikan.
- Memasukkan data bersarang dan menjangka lajur; nilai bersarang kekal sebagai teks JSON.
- Kehilangan perbezaan antara `null` dan `""`.
- Menggunakan `split('\t')` mudah pada output yang mengandungi sel berpetik.
- Menghantar objek yang nilainya ialah rekod; ia menjadi satu baris.

## Alat berkaitan

Tukar semula dengan [TSV ke JSON](https://toolsg.com/ms/tsv-to-json), tulis output berpisah koma dengan [JSON ke CSV](https://toolsg.com/ms/json-to-csv), semak input dengan [pengesah JSON](https://toolsg.com/ms/json-validator), atau lihat laluan dalam data anda dengan [JSON ke teks](https://toolsg.com/ms/json-to-text).

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

- [IANA — Media type text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) — Lines, tab separators, header line; fields containing tabs are not allowable.
- [IETF — RFC 4180, Common Format and MIME Type for CSV Files](https://www.rfc-editor.org/rfc/rfc4180.html) — The quoting convention this tool borrows.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
