Chuyển đổi JSON sang CSV (JSON to CSV Converter)

Công cụ chuyển đổi JSON sang CSV là gì?

Công cụ chuyển đổi JSON sang CSV là công cụ chuyển dữ liệu được biểu diễn bằng JSON thành văn bản dạng bảng CSV. Nhu cầu thường gặp là đưa một danh sách bản ghi từ hệ thống cung cấp JSON sang cách trình bày theo hàng và cột để tiếp tục xem hoặc sử dụng. Đây là chuyển đổi cách biểu diễn dữ liệu, không phải tính tổng, phân tích số liệu hay quy đổi đơn vị.

Mã được cung cấp xác nhận chiều mặc định của trang này là JSON sang CSV. Công cụ cũng có khả năng đảo chiều để đọc CSV và tạo JSON. Nội dung được xử lý khi ô đầu vào thay đổi; kết quả xuất hiện dưới dạng văn bản trong ô chỉ đọc và có thể được sao chép.

Dữ liệu dễ hình dung nhất là danh sách bản ghi phẳng, chẳng hạn danh mục sản phẩm, mỗi bản ghi có tên, số lượng và đơn vị. “Phẳng” nghĩa là các trường không chứa thêm những đối tượng hoặc danh sách nhiều tầng cần diễn giải riêng.

Tuy nhiên, đổi định dạng không đồng nghĩa tự sửa nội dung hoặc làm phẳng mọi cấu trúc. Công cụ cũng không bảo đảm kết quả sẽ được mọi phần mềm bảng tính đọc giống nhau. Phần chuyển đổi CSV được giao cho thư viện bên ngoài; mã thư viện chưa được cung cấp nên một số chi tiết về cách tạo và đọc CSV chưa thể xác minh.

Năm thuật ngữ cần hiểu khi chuyển đổi JSON và CSV

JSON

JSON là định dạng văn bản biểu diễn dữ liệu bằng đối tượng, mảng, chuỗi, số, giá trị đúng hoặc sai và null. Trong công cụ này, JSON là đầu vào mặc định và phải vượt qua bước phân tích cú pháp trước khi tạo CSV. Điểm dễ nhầm là JSON hợp lệ chưa chắc có hình dạng phù hợp với bảng: một cấu trúc nhiều tầng vẫn có thể đúng cú pháp nhưng cần cách tổ chức khác để thể hiện đầy đủ theo hàng và cột.

CSV

CSV là định dạng văn bản tổ chức dữ liệu thành các hàng và trường được phân cách. Nó thường được dùng để trao đổi dữ liệu dạng bảng, nhưng không phải một sổ tính có nhiều trang và định dạng ô. Một phần mềm có thể mở CSV rồi áp dụng cách hiểu riêng cho nội dung. Vì vậy, cần phân biệt văn bản CSV được tạo ra với cách bảng tính hiển thị số, ngày tháng hoặc mã định danh sau khi nhập.

Mảng đối tượng

Mảng đối tượng là danh sách gồm nhiều đối tượng, mỗi đối tượng chứa các cặp tên thuộc tính và giá trị. Với dữ liệu phẳng, mỗi đối tượng có thể được hình dung như một bản ghi. Đây là cấu trúc thuận tiện để giải thích việc chuyển sang bảng. Tuy nhiên, không phải mọi mảng JSON đều đồng nhất: các phần tử có thể khác trường hoặc khác loại dữ liệu. Mã tích hợp không kiểm tra đầy đủ sự đồng nhất đó.

Hàng tiêu đề

Hàng tiêu đề chứa tên các cột, khác với hàng chứa giá trị của một bản ghi. Ở chiều CSV sang JSON, công cụ yêu cầu thư viện dùng hàng đầu làm tên thuộc tính. Nếu dữ liệu bắt đầu ngay bằng một hàng thông tin sản phẩm, hàng ấy có thể bị hiểu là tên trường thay vì dữ liệu. Vì vậy, có tiêu đề hay không là khác biệt về cấu trúc, không chỉ về cách trang trí bảng.

Chuyển kiểu tự động

Chuyển kiểu tự động là việc bộ đọc diễn giải một số nội dung văn bản thành kiểu dữ liệu khác, thay vì giữ mọi ô dưới dạng chuỗi. Công cụ bật yêu cầu này khi đọc CSV. Nó khác với việc chỉ đổi cách hiển thị một ô trong bảng tính. Những trường như mã hàng hoặc mã khách hàng cần được chú ý vì hình thức giống số không nhất thiết mang ý nghĩa số. Các trường hợp chuyển kiểu cụ thể chưa được xác minh do thiếu mã thư viện.

Dữ liệu đầu vào và ý nghĩa kết quả chuyển đổi

Dữ liệu phù hợp để đưa vào

Đầu vào là văn bản được nhập hoặc dán vào ô dữ liệu, không phải tệp được tải lên. Ở chiều JSON sang CSV, văn bản phải đúng cú pháp JSON. Danh sách các bản ghi phẳng, có cùng bộ thuộc tính là lựa chọn dễ đối chiếu, nhưng đây là khuyến nghị chuẩn bị dữ liệu, không phải điều kiện được công cụ kiểm tra toàn diện.

Một đối tượng riêng lẻ cũng được chuẩn bị thành danh sách một phần tử trước khi chuyển đổi. Ngược lại, các giá trị JSON khác dù phân tích được vẫn chưa chắc thích hợp để tạo bảng. Đơn vị như đồng, chiếc hoặc kilôgam phải do người dùng xác định trong nội dung hoặc tài liệu đi kèm; công cụ không suy ra hay quy đổi chúng.

Cách đọc kết quả và trạng thái

Ở chiều mặc định, đầu ra là chuỗi CSV do thư viện tạo. Khi đọc CSV về JSON, hàng đầu được dùng làm tên thuộc tính và JSON kết quả được trình bày với thụt lề hai dấu cách. Thụt lề chỉ giúp đọc cấu trúc dễ hơn, không phải làm tròn số hay điều chỉnh giá trị.

Trạng thái “Hợp lệ” cho biết lần xử lý hoàn tất mà không đi vào nhánh lỗi. Nó không chứng minh tên cột đúng yêu cầu, đơn vị thống nhất hoặc dữ liệu chính xác về nghiệp vụ. Kết quả nằm trong ô chỉ đọc và có chức năng sao chép dưới dạng văn bản. Giao diện được cung cấp không có chức năng tải lên tệp hoặc tải xuống tệp CSV.

Công cụ xử lý dữ liệu theo những quy tắc nào?

Từ JSON đến dữ liệu dạng bảng

Trước khi xử lý, công cụ loại bỏ khoảng trắng ở hai đầu toàn bộ văn bản. Với đầu vào không rỗng, bước tiếp theo là phân tích cú pháp JSON. Nếu kết quả là mảng, mảng được chuyển tiếp cho thư viện. Nếu không phải mảng, giá trị được bọc trong một mảng một phần tử. Với một đối tượng sản phẩm, điều này chuẩn bị dữ liệu như danh sách một bản ghi.

Bước bọc không phải phép kiểm tra rằng mọi giá trị đều phù hợp với bảng. Công cụ gọi thư viện tạo CSV mà không truyền cấu hình tùy chỉnh. Vì thế, cách chọn cột, đặt dấu ngoặc kép, dùng dấu phân cách và xuống dòng phụ thuộc hành vi của thư viện chưa được cung cấp. Lớp tích hợp không thực hiện công thức tính toán hoặc quy tắc làm tròn riêng.

Từ CSV về JSON

Chiều đọc CSV có ba yêu cầu rõ ràng: dùng hàng đầu làm tiêu đề, bỏ qua dòng trống và bật chuyển kiểu tự động. Dữ liệu thư viện trả về sau đó được biểu diễn thành JSON với thụt lề hai dấu cách. Không thể từ những thiết lập này suy ra đầy đủ cách nhận diện dấu phân cách hoặc cách xử lý mọi giá trị đặc biệt.

Nếu nhu cầu chính là chiều ngược, công cụ chuyển đổi CSV sang JSON là lựa chọn liên quan. Dù dùng chiều nào, ý nghĩa hàng tiêu đề vẫn cần khớp với dữ liệu nguồn.

Khi dữ liệu trống, có lỗi hoặc được đảo chiều

Nếu văn bản sau khi loại bỏ khoảng trắng là rỗng, công cụ dừng trước khi gọi thư viện, làm rỗng đầu ra và hiển thị trạng thái chờ nhập liệu. Xóa trắng đầu vào cũng dẫn tới kết quả này. Thông báo lỗi cũ được ẩn ở đầu mỗi lần xử lý.

Khi có lỗi được bắt, kết quả bị xóa và thông báo lỗi xuất hiện. Với CSV, danh sách lỗi không rỗng do thư viện trả về cũng được chuyển thành lỗi hiển thị, không giữ lại kết quả một phần. Đảo chiều thì khác: công cụ lấy chính kết quả hiện tại làm đầu vào mới rồi chuyển đổi theo chiều ngược, thay vì giữ nguyên văn bản đầu vào trước đó.

Khi nào nên dùng chuyển đổi JSON sang CSV?

Chuẩn bị dữ liệu cho cách xem dạng bảng

Chuyển sang CSV phù hợp khi bạn có danh sách bản ghi phẳng và muốn quan sát từng trường theo cột. Ví dụ, danh mục sản phẩm giả định có tên, số lượng và đơn vị có thể dễ đối chiếu hơn trong cách xem dạng bảng. Công cụ tạo văn bản CSV; việc nhập và hiển thị trong phần mềm bảng tính vẫn là công đoạn riêng.

Một tình huống khác là dữ liệu lấy từ hệ thống cung cấp JSON nhưng nơi nhận yêu cầu CSV. Khi đó, thay đổi định dạng chỉ giải quyết một phần yêu cầu. Bạn vẫn cần kiểm tra tên cột, trường bắt buộc, đơn vị và cấu trúc mà nơi nhận chấp nhận. Công cụ không tự đối chiếu với yêu cầu của hệ thống đích.

Đối chiếu dữ liệu trước khi sử dụng

Chiều CSV về JSON có ích khi cần xem dữ liệu dưới dạng tên trường và bản ghi để hiểu nội dung. Tuy nhiên, đây không phải tính năng làm sạch hay kiểm toán dữ liệu. Chuyển thành JSON không tự phát hiện tên sản phẩm sai, mã bị nhầm hoặc số lượng bất hợp lý.

Sau chuyển đổi, nên đối chiếu số bản ghi, các cột mong đợi, trường cần giữ dạng văn bản và đơn vị đi kèm. Nếu dùng kết quả để nhập vào một hệ thống khác, hãy kiểm tra một phần dữ liệu trước khi sử dụng toàn bộ. Đây là thực hành kiểm tra của người dùng, không phải bước xác nhận tự động do công cụ thực hiện.

Ví dụ chuyển đổi và cách hiểu từng tình huống

Một đối tượng và một danh sách nhiều bản ghi

Giả sử dữ liệu sản phẩm hoàn toàn giả định là:

{"ten": "Bút mẫu", "so_luong": 3, "don_vi": "chiếc"}

Văn bản này biểu diễn một đối tượng. Theo quy tắc trong mã tích hợp, công cụ phân tích JSON rồi bọc đối tượng thành mảng một phần tử trước khi yêu cầu thư viện tạo CSV. Số lượng là 3 chiếc vì dữ liệu đã ghi đơn vị ấy; công cụ không tự nhận biết “chiếc” từ tên sản phẩm.

Có thể xác nhận bước chuẩn bị một bản ghi, nhưng chưa thể chốt chuỗi CSV chính xác, bao gồm dấu phân cách và cách trích dẫn. Ví dụ này minh họa luồng xử lý từ mã, không phải kết quả đã chạy thử.

Với danh sách hai sản phẩm giả định:

[
  {"ten": "Bút mẫu", "so_luong": 3, "don_vi": "chiếc"},
  {"ten": "Vở mẫu", "so_luong": 2, "don_vi": "quyển"}
]

Kết quả phân tích đã là mảng nên công cụ không bọc thêm tầng mảng. Hai bản ghi được đưa cùng nhau vào thư viện. Công cụ không cộng 3 chiếc với 2 quyển, không chuyển thành một tổng số lượng có đơn vị chung và không quy đổi các đơn vị. Chi tiết văn bản CSV vẫn phụ thuộc bước tạo CSV của thư viện.

Dữ liệu trống và JSON sai cú pháp

Nếu đầu vào chỉ gồm ba dấu cách và một ký tự xuống dòng, thao tác loại bỏ khoảng trắng ở hai đầu khiến văn bản trở thành rỗng. Ở cả hai chiều, công cụ không gọi thư viện, ô kết quả rỗng và trạng thái là “Chờ nhập liệu…”. Thông báo lỗi trước đó cũng được ẩn. Tình huống này được xác định trực tiếp từ mã tích hợp.

Một trường hợp sai cú pháp là:

{ten: "Bút mẫu", "so_luong": 3}

Tên thuộc tính đầu tiên không nằm trong dấu ngoặc kép nên văn bản không phải JSON hợp lệ. Lỗi xảy ra ở bước phân tích JSON, trước khi gọi thư viện tạo CSV. Công cụ xóa đầu ra, đổi trạng thái sang lỗi dữ liệu và hiển thị thông báo. Câu chữ chi tiết của thông báo phụ thuộc môi trường JavaScript, nên không cần giả định một thông báo cố định để hiểu nguyên nhân.

Chuyển sang CSV khác gì với giữ nguyên JSON?

Chọn định dạng theo mục đích sử dụng

Về kiến thức nền, JSON có thể biểu diễn cấu trúc phân cấp và phân biệt các kiểu dữ liệu như chuỗi, số hoặc boolean. CSV tập trung vào hàng và trường trong văn bản phân cách. Hai định dạng vì vậy không có khả năng biểu đạt hoàn toàn tương đương, nhất là khi một bản ghi chứa danh sách con hoặc đối tượng nhiều tầng.

Với dữ liệu phẳng cần xem theo bảng, CSV có thể phù hợp hơn cho nơi nhận. Nếu mục tiêu là giữ cấu trúc phân cấp để hệ thống khác tiếp tục đọc, giữ JSON có thể hợp lý hơn. Việc lựa chọn nên dựa trên yêu cầu sử dụng, không phải mặc định rằng đổi sang CSV luôn làm dữ liệu tốt hơn.

Chuyển đổi không chỉ là làm đẹp văn bản

Làm đẹp JSON thường là thay đổi khoảng trắng, thụt lề và xuống dòng để dễ đọc trong cùng định dạng. Chuyển JSON sang CSV thay đổi cách tổ chức biểu diễn dữ liệu sang hàng và cột. Đó là khác biệt lớn hơn việc trình bày lại một văn bản.

Chuyển đi rồi chuyển về cũng không tự chứng minh mọi thông tin được bảo toàn. Kiểu dữ liệu hoặc hình thức văn bản có thể chịu ảnh hưởng của bước đọc CSV. Mã được cung cấp không có chức năng so sánh mức tương đương giữa dữ liệu trước và sau, nên vẫn cần đối chiếu các trường quan trọng.

Giới hạn và những điểm cần kiểm tra trước khi dùng kết quả

Cấu trúc và kiểu dữ liệu cần thận trọng

Không có bước làm phẳng JSON lồng nhau trong mã tích hợp. Cũng chưa có căn cứ để hứa hợp nhất đầy đủ các cột khi bản ghi khác bộ thuộc tính. Cách xử lý trường thiếu, tiêu đề trùng, dấu phân cách và ô chứa dòng mới phụ thuộc thư viện chưa được cung cấp.

Cần kiểm tra riêng mã định danh, số lớn và giá trị phải giữ nguyên dạng văn bản. Không nên kết luận trước rằng một mã có số 0 đầu chắc chắn được giữ hoặc chắc chắn bị đổi. Phạm vi chuyển kiểu tự động chưa được xác minh cho những trường hợp này.

Dung lượng, sao chép và dữ liệu nhạy cảm

Mã không đặt giới hạn dung lượng hoặc số dòng, nhưng điều đó không chứng minh khả năng xử lý vô hạn. Chuyển đổi diễn ra khi nội dung thay đổi; dữ liệu lớn cần được đánh giá theo môi trường sử dụng. Không có số liệu hiệu năng để cam kết một quy mô cụ thể.

Sao chép tự động phụ thuộc trình duyệt và quyền truy cập clipboard. Lỗi sao chép không đồng nghĩa lỗi chuyển đổi. Ngoài ra, chưa thể xác nhận chính sách lưu hoặc truyền dữ liệu của toàn trang chỉ từ phần mã này; nên tránh dán dữ liệu nhạy cảm khi chưa rõ chính sách.

Trước khi mở CSV từ nguồn không tin cậy trong bảng tính, hãy kiểm tra nội dung có thể bị diễn giải thành công thức. Lời gọi tạo CSV không thể hiện cấu hình phòng ngừa riêng, nhưng cũng chưa đủ để kết luận mọi biện pháp bảo vệ của thư viện có hay không.

Câu hỏi thường gặp

Tôi có thể chuyển một đối tượng JSON riêng lẻ thay vì cả mảng không?

Có. Với một đối tượng JSON riêng lẻ, công cụ bọc nó thành mảng một phần tử rồi đưa vào thư viện tạo CSV. Bạn không bắt buộc phải tự thêm cấu trúc danh sách cho trường hợp này. Tuy nhiên, việc được bọc thành mảng không bảo đảm mọi nội dung bên trong đều phù hợp với bảng. Nếu đối tượng chứa cấu trúc nhiều tầng, cách biểu diễn CSV vẫn cần kiểm tra vì mã tích hợp không có bước làm phẳng dữ liệu.

Vì sao JSON nhìn có vẻ đúng nhưng công cụ vẫn báo lỗi?

Hình thức giống JSON không đồng nghĩa đúng cú pháp JSON. Tên thuộc tính thiếu dấu ngoặc kép, dấu phẩy thừa hoặc chuỗi chưa đóng đều có thể khiến bước phân tích thất bại. Ngoài ra, JSON phân tích được vẫn có thể gặp vấn đề khi đưa sang thư viện chuyển đổi. Hãy dựa vào thông báo lỗi và cấu trúc dữ liệu, thay vì chỉ nhìn cách xuống dòng. Khi lỗi được bắt, công cụ làm rỗng kết quả để không giữ đầu ra cũ.

Mã có số 0 ở đầu có được giữ nguyên khi đổi CSV về JSON không?

Chưa thể bảo đảm từ mã được cung cấp. Công cụ bật chuyển kiểu tự động khi đọc CSV, nhưng phạm vi xử lý cụ thể của thư viện đối với mã có số 0 đầu chưa được xác minh. Mã định danh nên được hiểu theo ý nghĩa văn bản, dù trông giống số. Bạn cần đối chiếu giá trị sau chuyển đổi với nguồn ban đầu, nhất là khi số 0 là một phần bắt buộc của mã, và không coi trạng thái hợp lệ là bằng chứng bảo toàn hình thức.

CSV tạo ra có chắc chắn hiển thị đúng trong Excel không?

Không có đủ căn cứ để bảo đảm điều đó. Công cụ tạo văn bản CSV, còn Excel có cách nhập và diễn giải dữ liệu riêng. Tên cột, ký tự tiếng Việt, mã dạng số và những nội dung giống ngày tháng đều là các điểm nên kiểm tra trong phần mềm đích. Mã thư viện và kết quả kiểm tra tương thích chưa được cung cấp. Vì vậy, chuyển đổi hoàn tất không thay thế việc mở và đối chiếu bảng trong môi trường thực sự sử dụng.

Đảo chiều hai lần có khôi phục nguyên dữ liệu ban đầu không?

Không được bảo đảm. Mỗi lần đảo chiều dùng kết quả hiện tại làm đầu vào mới, nên dữ liệu đi qua bước tạo CSV rồi bước đọc CSV với cấu hình chuyển kiểu tự động. Ngay cả khi nội dung chính còn tương ứng, khoảng trắng, cách trình bày hoặc kiểu dữ liệu không nhất thiết giống ban đầu. Công cụ không thực hiện phép so sánh trước và sau. Nếu cần giữ nguyên bản gốc, bạn nên lưu riêng nó trước khi dùng chức năng đảo chiều.

Vì sao có kết quả nhưng không sao chép tự động được?

Vì sao chép là thao tác riêng, phụ thuộc khả năng và quyền truy cập clipboard của trình duyệt. Công cụ chỉ báo sao chép thành công sau khi yêu cầu ghi văn bản hoàn tất; nếu yêu cầu thất bại, nó hiển thị thông báo. Điều này không tự làm cho nội dung kết quả trở thành sai. Ngoài ra, chức năng sao chép không thực hiện khi đầu ra rỗng hoặc đang hiển thị lỗi, nên cần phân biệt tình trạng đó với việc trình duyệt từ chối thao tác.

Công cụ có cho tải lên tệp JSON hoặc tải xuống tệp CSV không?

Không có các chức năng đó trong giao diện được cung cấp. Cách tiếp nhận dữ liệu là nhập hoặc dán văn bản, còn cách lấy kết quả được thể hiện là sao chép nội dung từ ô đầu ra. Vì vậy, không nên hiểu công cụ này có sẵn quy trình nhập tệp hay xuất tệp tải xuống. Nếu công việc yêu cầu một tệp để gửi cho nơi khác, việc tạo và kiểm tra tệp ấy là công đoạn riêng, không phải chức năng đã được xác nhận ở đây.