# JSON ke teks laluan kunci: format laluan = nilai dan kekaburannya

> Cara JSON bersarang diratakan kepada satu baris 'laluan = nilai' bagi setiap daun, cara tatasusunan dan bekas kosong muncul, dan kes di mana dokumen berbeza menghasilkan baris yang sama.

- Tool: [Penukar JSON ke teks biasa](https://toolsg.com/ms/json-to-text)
- 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 |
| --- | --- | --- |
| Format baris | laluan = nilai, satu baris setiap daun — Kunci objek disambung dengan titik; kedudukan tatasusunan ditulis [0], [1] … |  |
| Bekas kosong | Ditulis sebagai [] atau {} — Baris lain hanya ditulis untuk nilai daun, jadi tatasusunan dan objek kosong mendapat barisnya sendiri. |  |
| Rentetan | Ditulis tanpa petikan — Maka rentetan "null" dan nilai null kelihatan serupa. |  |
| Muat turun | converted.txt — Teks biasa yang mengandungi tepat apa yang ditunjukkan kotak output. |  |

## Apa yang dihasilkan alat ini

Tampal JSON dan kotak kanan menyenaraikan setiap nilai daun (rentetan, nombor, boolean atau null) pada barisnya sendiri sebagai `laluan = nilai`. Laluan dibina daripada kunci di atasnya: kunci objek disambung dengan `.`, dan item tatasusunan ditulis sebagai `[indeks]` dengan indeks bermula dari sifar dan tiada titik sebelum kurungan. Penukaran berjalan dalam pelayar dan dikemas kini semasa anda menaip; pautan Muat turun (`converted.txt`) muncul apabila ada output.

Contoh input: `{"user":{"name":"Mei","langs":["en","zh"],"address":{"city":"SG","unit":null},"empty":[],"none":{}},"ok":true,"n":1.50,"s":"null"}`

```
user.name = Mei
user.langs[0] = en
user.langs[1] = zh
user.address.city = SG
user.address.unit = null
user.empty = []
user.none = {}
ok = true
n = 1.5
s = null
```

Teks yang sama juga menunjukkan had format: `1.50` dicetak sebagai `1.5`, dan rentetan `"null"` (baris terakhir) kelihatan sama seperti `null` sebenar pada baris `unit`.

## Akar tatasusunan dan akar skalar

Tatasusunan di peringkat atas memulakan setiap laluan dengan indeks: `[{"name":"Mei","age":30},{"name":"Ali","age":25}]` menjadi `[0].name = Mei`, `[0].age = 30`, `[1].name = Ali`, `[1].age = 25`. Tatasusunan bersarang menyambung indeks: `[[1,2],[3]]` memberi `[0][0] = 1`, `[0][1] = 2`, `[1][0] = 3`. Skalar tunggal seperti `5` atau `"hi"` menjadi `value = 5` dan `value = hi`. `[]` atau `{}` di peringkat atas ditulis sebagai ` = []` atau ` = {}` dengan ruang di hadapan, kerana laluannya kosong.

## Di mana output kabur

Format ini bertujuan untuk dibaca, di-grep dan dibandingkan, bukan untuk ditukar semula kepada JSON. Dokumen berbeza boleh menghasilkan baris yang serupa:

| Input | Output | Masalah |
| --- | --- | --- |
| `{"a.b":1}` dan `{"a":{"b":1}}` | kedua-duanya `a.b = 1` | Titik dalam kunci tidak di-escape |
| `{"a[0]":1}` dan `{"a":[1]}` | kedua-duanya `a[0] = 1` | Kurungan dalam kunci tidak di-escape |
| `"null"` dan `null` | kedua-duanya `= null` | Rentetan tiada petikan |
| `"true"` dan `true`, `"5"` dan `5` | serupa | Sebab yang sama |
| `{"a":"x = y"}` | `a = x = y` | ` = ` pertama ialah pemisah; yang berikutnya sebahagian daripada nilai |
| `{"a":"line1\nline2"}` | dua baris fizikal | Baris baharu dalam rentetan melanggar peraturan satu baris setiap daun |
| `{"":1}` | `value = 1` | Kunci kosong meninggalkan laluan kosong, dipaparkan sebagai `value` |
| `{"a":{"":2}}` | `a. = 2` | Kunci kosong selepas titik |

Ruang di awal dan akhir rentetan dikekalkan, jadi `"  pad  "` dicetak sebagai `a =   pad  ` dan ruang itu mudah terlepas pandang.

## Nombor dan susunan

Nilai melalui `JSON.parse`, jadi nombor ialah double JavaScript: `12345678901234567890` dicetak sebagai `12345678901234567000`, `-0` sebagai `0`, dan `1e400` sebagai `Infinity`. Kunci seperti integer keluar dahulu dan menaik; kunci lain mengekalkan susunan sumber. Kunci berulang hanya mengekalkan nilai terakhir.

> **Petua:** Untuk mencari lokasi sesuatu nilai dalam respons besar, tukarkannya di sini dan cari nilai itu dalam output. Setiap padanan sudah membawa laluan penuh, yang boleh anda gunakan dalam [pemapar JSON](https://toolsg.com/ms/json-viewer).

## Kesilapan biasa

- Menjangka format yang boleh diterbalikkan. Jika anda perlu membina semula JSON daripada baris ini, gunakan pembatas yang tidak mungkin ada dalam kunci, atau simpan dokumen asal.
- Membaca `null` tanpa petikan sebagai null JSON sedangkan nilainya mungkin teks "null".
- Menganggap laluan sebagai JSONPath. JSONPath (RFC 9535) bermula dengan `$`, meletakkan petikan pada kunci luar biasa dan mempunyai skema escape yang berbeza.
- Memasukkan JSON Lines (beberapa dokumen) sekaligus; penghurai hanya menerima satu teks JSON dan melaporkan ralat.

## Alat berkaitan

Teroka struktur secara visual dengan [pemapar JSON](https://toolsg.com/ms/json-viewer), ratakan tatasusunan rekod kepada jadual dengan [JSON ke CSV](https://toolsg.com/ms/json-to-csv) atau [JSON ke TSV](https://toolsg.com/ms/json-to-tsv), dan bandingkan dua output yang diratakan dengan [perbandingan teks](https://toolsg.com/ms/text-diff).

## 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 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — The value types being flattened.
- [IETF — RFC 9535, JSONPath](https://www.rfc-editor.org/rfc/rfc9535.html) — A standard path syntax (for example $.user.langs[0]); this tool's paths are similar but not JSONPath.
