# TSV ke JSON: penghuraian berpisah tab, petikan dan data hamparan yang ditampal

> Cara penukar ini membaca teks berpisah tab (tab sahaja, baris pertama sebagai pengepala, petikan gaya CSV dihormati, semuanya rentetan), perbezaannya daripada takrifan IANA text/tab-separated-values, dan cara baris tidak sekata serta baris kosong berfungsi.

- Tool: [Penukar TSV ke JSON](https://toolsg.com/ms/tsv-to-json)
- 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 |
| --- | --- | --- |
| Pembatas | Tab sahaja — Koma dan ruang ialah aksara biasa; garis condong terbalik diikuti t secara literal tidak ditukar menjadi tab. | [IANA — text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) |
| Baris pengepala | Sentiasa baris pertama — Selnya menjadi kunci JSON; tiada pilihan untuk mematikan pengepala. |  |
| Jenis nilai | Setiap nilai ialah rentetan — 30 menjadi "30", 007 kekal "007". |  |
| Petikan | Medan yang bermula dengan " dibaca sebagai berpetik — Di dalamnya tab dan pemisah baris dikekalkan dan "" ialah satu petikan. Pendaftaran IANA tidak menakrifkan petikan. |  |

## Apa yang dilakukan penukar

Tampal teks berpisah tab dan kotak kanan menunjukkan tatasusunan JSON dengan satu objek bagi setiap baris data, diinden dua ruang. Ia dikemas kini semasa anda menaip, tiada apa dimuat naik, dan pautan Muat turun (`converted.json`) muncul apabila ada output. Ini format semula jadi bagi data yang disalin daripada julat hamparan, kerana program hamparan lazimnya meletakkan tab di antara sel dan pemisah baris di antara baris; tampal terus ke kotak kiri.

Contoh input (di sini `→` mewakili aksara tab):

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

memberi

```json
[
  { "name": "Mei", "city": "Singapore", "age": "30" },
  { "name": "Ali", "city": "Johor", "age": "25" }
]
```

Nilai sentiasa rentetan: `"30"`, bukan `30`. Koma, ruang dan koma bertitik tidak bermakna di sini, jadi `1, 2` kekal `"1, 2"`.

## TSV dalam piawaian berbanding alat ini

Pendaftaran IANA bagi `text/tab-separated-values` ringkas. Setiap rekod ialah satu baris, medan dipisahkan oleh tab, setiap rekod mempunyai bilangan medan yang sama, baris pertama menamakan medan, dan "medan yang mengandungi tab tidak dibenarkan dalam pengekodan ini". Ia tidak menakrifkan petikan atau escape, jadi pembaca ketat tidak dapat mewakili tab atau pemisah baris dalam nilai.

Alat ini lebih murah hati. Ia menggunakan pengendalian petikan yang sama dengan saudara CSV-nya (konvensyen RFC 4180): medan yang aksara pertamanya `"` ialah medan berpetik yang tab dan pemisah barisnya literal, dan `""` mewakili satu petikan. Maka `"has<TAB>tab"` menjadi satu nilai `has\ttab` dan `"two<newline>lines"` menjadi nilai dua baris. Ini membantu bagi fail yang ditulis oleh alat yang memberi petikan, tetapi bermakna nilai biasa yang kebetulan bermula dengan petikan berganda dimakan sebagai petikan, dan petikan sesat di permulaan medan tanpa penutup gagal dengan "Medan berpetik tidak ditutup — semak tanda petik berganda yang tertinggal."

Petikan berganda di tengah medan dikekalkan sebagai teks (`x"y` kekal `x"y`). Ruang tidak pernah dipangkas. Jujukan escape tidak dinyahkod: dua aksara `\` dan `t` kekal seadanya.

## Baris, pengepala dan baris kosong

| Input | Hasil |
| --- | --- |
| baris dengan sel lebih sedikit | sel yang tiada menjadi `""` |
| baris dengan sel lebih banyak daripada pengepala | sel berlebihan dibuang secara senyap |
| nama pengepala berulang | lajur kemudian menang |
| sel pengepala kosong | kunci `column_N`, N ialah kedudukan |
| baris kosong antara baris | rekod rentetan kosong |
| baris pengepala sahaja | `[]` |
| hujung baris CRLF, CR atau LF | semuanya diterima; satu baris baharu di hujung diabaikan |
| tanda tertib bait UTF-8 di awal | dikekalkan dalam nama kunci pertama |

Baris yang `x` diikuti satu tab (sel kedua kosong) memberi `{"a":"x","b":""}`, dan tab di hadapan memberi nilai pertama kosong. Ini penting semasa menampal daripada hamparan: sel kosong di hujung dikekalkan sebagai rentetan kosong dan tidak dibuang.

> **Petua:** Jika sel hamparan mengandungi pemisah baris, semak bagaimana sumber menulisnya. Apabila teks tiba berpetik, seperti `"line1<newline>line2"`, penukar ini mengekalkan pemisah baris di dalam nilai; pemisah baris tanpa petikan memulakan baris baharu.

## Kesilapan biasa

- Menampal data berpisah koma dan mendapat satu kunci: gunakan [CSV ke JSON](https://toolsg.com/ms/csv-to-json).
- Menampal teks yang tabnya ditukar kepada ruang oleh penyunting atau aplikasi sembang; maka tiada pembatas tab lagi.
- Menjangka nombor, boolean atau `null`.
- Memulakan nilai dengan petikan berganda (ukuran seperti `5"`) dan mendapat ralat petikan atau teks yang ditelan.
- Menjangka `\t` yang ditulis sebagai dua aksara menjadi tab.

## Alat berkaitan

Tukar semula dengan [JSON ke TSV](https://toolsg.com/ms/json-to-tsv), baca fail berpisah koma dengan [CSV ke JSON](https://toolsg.com/ms/csv-to-json), semak output dengan [pengesah JSON](https://toolsg.com/ms/json-validator), atau layari 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

- [IANA — Media type text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) — Records are lines, fields are separated by tabs, the first line names the fields, and 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 applies to tab-separated text as well.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
