Trình chuyển đổi TOML sang JSON

Chào mừng bạn đến với Trình Chuyển Đổi TOML sang JSON, một công cụ trực tuyến miễn phí giúp biến mọi cấu hình TOML thành JSON sạch và hợp lệ chỉ bằng một cú nhấp chuột. Cho dù bạn đang di chuyển Cargo.toml sang một quy trình dựa trên JSON, gỡ lỗi các cài đặt lồng nhau sâu một cách trực quan, hoặc cung cấp tệp TOML cho một dịch vụ chỉ chấp nhận JSON, trình chuyển đổi này xử lý chính xác mọi cấu trúc TOML: bảng (tables), bảng con (sub-tables), mảng các bảng (arrays of tables), bảng nội dòng (inline tables), khóa dạng chấm (dotted keys), chuỗi nhiều dòng, số nguyên dạng hex/bát phân/nhị phân, ngày tháng và các số thực đặc biệt. Hãy chọn kiểu đầu ra phù hợp với quy trình làm việc của bạn — đẹp 2-khoảng-cách, đẹp 4-khoảng-cách, thu gọn hoặc sắp xếp theo khóa — và kiểm tra kết quả thông qua cây cấu trúc, bảng thống kê và sơ đồ chuyển đổi.

TOML là gì và Tại sao nên Chuyển đổi nó sang JSON?

TOML (Tom's Obvious Minimal Language) là một định dạng cấu hình được thiết kế để không gây nhầm lẫn và dễ đọc cho con người. Nó cung cấp siêu dữ liệu gói cho Cargo (Rust), Poetry (Python) và nhiều công cụ dành cho nhà phát triển khác. Mặt khác, JSON là định dạng trao đổi dữ liệu phổ biến trên web. Nhiều hệ thống — REST API, cơ sở dữ liệu tài liệu, localStorage của trình duyệt và ứng dụng JavaScript — chỉ giao tiếp bằng JSON. Chuyển đổi TOML sang JSON cho phép bạn kết nối hai thế giới này mà không cần viết lại cấu hình.

Các Lý do Phổ biến để Chuyển đổi TOML sang JSON

• Truyền TOML vào một API chỉ hỗ trợ JSON — ví dụ: dịch vụ triển khai hoặc nền tảng gắn cờ tính năng (feature-flag).
• Kiểm tra trực quan các cấu hình lồng nhau sâu — cấu trúc ngoặc vuông và ngoặc nhọn của JSON giúp phân cấp rõ ràng ngay lập tức.
• Tạo các gói cấu hình front-end — giữ định dạng soạn thảo của bạn ở TOML, chuyển JSON tới trình duyệt.
• Làm việc với linter và JSON Schema — xác thực cấu trúc TOML bằng cách định tuyến nó qua trình xác thực JSON Schema.
• So sánh các cấu hình — so sánh diff JSON đã sắp xếp khóa giữa các môi trường để phát hiện sự sai lệch.
• Di chuyển cấu hình cũ — dần dần chuyển một tệp TOML sang một dịch vụ cấu hình dựa trên JSON.

Các Tính năng Chính của Trình Chuyển đổi này

• Hỗ trợ đầy đủ TOML 1.0 — chuỗi cơ bản và ký tự nguyên bản (đơn và nhiều dòng), số nguyên ở dạng thập phân/thập lục phân/bát phân/nhị phân với dấu gạch dưới ngăn cách, số thực với ký hiệu khoa học, inf, -inf, nan, giá trị logic (booleans), ngày tháng và thời gian.
• Cấu trúc lồng nhau — bảng, bảng con ([a.b.c]), mảng các bảng ([[a]]), bảng nội dòng ({ a = 1, b = 2 }) và các khóa dạng chấm.
• Bốn kiểu đầu ra — đẹp 2-khoảng-cách, đẹp 4-khoảng-cách, thu gọn (đã nén) và sắp xếp khóa để đầu ra dễ so sánh diff.
• Cây cấu trúc trực quan — xem cách các cấu trúc TOML trở thành các đối tượng và mảng JSON, với các huy hiệu loại dữ liệu (table, AoT, array, string, number, bool).
• Bảng điều khiển thống kê — số lượng bảng, khóa, mảng, mảng các bảng, độ sâu, cùng với số lượng ký tự đầu vào/đầu ra.
• Thông báo lỗi theo từng dòng — mọi lỗi phân tích cú pháp đều bao gồm số dòng chính xác để bạn có thể sửa lỗi ngay lập tức.
• Thư viện mẫu một cú nhấp chuột — tải các ví dụ kiểu Cargo.toml, kiểu pyproject, cấu hình ứng dụng, số hoặc chuỗi nhiều dòng.
• Sao chép và tải xuống — sao chép JSON vào bộ nhớ tạm hoặc tải xuống dưới dạng tệp .json.
• Tương thích di động — hoạt động tốt trên điện thoại, máy tính bảng và máy tính để bàn.
• Không có dữ liệu nào rời khỏi yêu cầu trình duyệt của bạn — TOML được phân tích phía máy chủ và kết quả được trả về trong cùng một phản hồi; không có gì được lưu trữ.

Cách TOML Ánh xạ sang JSON

Hầu hết các cấu trúc TOML đều có một tương đương JSON sạch sẽ và không mất dữ liệu. Đây là cách ánh xạ mà trình chuyển đổi áp dụng:

Ví dụ

title = "App"
[server]
host = "localhost"
port = 8080

{
  "title": "App",
  "server": {
    "host": "localhost",
    "port": 8080
  }
}

[[user]]
name = "Alice"
admin = true

[[user]]
name = "Bob"
admin = false

{
  "user": [
    { "name": "Alice", "admin": true },
    { "name": "Bob",   "admin": false }
  ]
}

db.host = "10.0.0.1"
db.port = 5432
db.options = { ssl = true, pool = 20 }

{
  "db": {
    "host": "10.0.0.1",
    "port": 5432,
    "options": { "ssl": true, "pool": 20 }
  }
}

Cách Sử dụng Trình Chuyển đổi TOML sang JSON

1. Dán TOML của bạn vào ô nhập liệu, hoặc nhấp vào một thẻ Mẫu Nhanh để tải một cấu hình điển hình.
2. Chọn một kiểu đầu ra — đẹp 2-khoảng-cách (mặc định), đẹp 4-khoảng-cách, thu gọn hoặc sắp xếp khóa.
3. Nhấp vào Chuyển đổi sang JSON. Công cụ sẽ phân tích TOML và hiển thị đầu ra JSON cùng với thống kê và cây cấu trúc.
4. Kiểm tra kết quả — xem bảng thống kê để có tóm tắt nhanh, mở rộng cây cấu trúc để xem hệ thống phân cấp và đọc sơ đồ chuyển đổi để hiểu cách ánh xạ.
5. Sao chép hoặc tải xuống JSON. Nút Sao chép sẽ đưa nó vào bộ nhớ tạm; Tải xuống sẽ lưu nó dưới dạng converted.json.

Các Tính năng TOML Được Hỗ trợ

Chuỗi (Strings)

• Chuỗi cơ bản sử dụng dấu ngoặc kép và hỗ trợ các chuỗi thoát: \n, \t, \r, \", \\, \uXXXX, \UXXXXXXXX.
• Chuỗi ký tự nguyên bản sử dụng dấu ngoặc đơn và chứa các ký tự thô không có chuỗi thoát.
• Chuỗi cơ bản nhiều dòng sử dụng ba dấu ngoặc kép (""") và hỗ trợ dấu gạch chéo ngược ở cuối dòng để xóa khoảng trắng.
• Chuỗi ký tự nguyên bản nhiều dòng sử dụng ba dấu ngoặc đơn (''') và giữ nguyên mọi thứ văn bản gốc.

Số (Numbers)

• Số nguyên thập phân với các dấu gạch dưới ngăn cách tùy chọn: 1_000_000.
• Số nguyên Hex/bát phân/nhị phân: 0xDEADBEEF, 0o755, 0b1010.
• Số thực với dấu, phần thập phân và số mũ tùy chọn: 3.14, -2e-3, 6.022e23.
• Số thực đặc biệt: inf, -inf, nan (được chuyển đổi thành JSON null).

Bảng và Mảng (Tables and Arrays)

• Bảng: [name] mở một bảng mới.
• Bảng con: [a.b.c] tạo các bảng lồng nhau.
• Mảng các bảng: [[name]] thêm một bảng mới vào một mảng.
• Bảng nội dòng: { a = 1, b = 2 }.
• Mảng: [1, 2, 3] có thể trải dài trên nhiều dòng và chứa các loại giá trị hỗn hợp.

Chọn Kiểu Đầu ra Phù hợp

• Đẹp 2-khoảng-cách — mặc định. Thu gọn nhưng vẫn dễ đọc; lý tưởng cho hầu hết các trường hợp sử dụng bao gồm các tệp cấu hình được commit vào git.
• Đẹp 4-khoảng-cách — khớp với kiểu thụt lề PEP-8; được ưa chuộng bởi một số đội ngũ làm việc với Python và Java.
• Thu gọn (minified) — một dòng duy nhất, không có khoảng trắng thừa; kích thước nhỏ nhất để truyền tải qua mạng.
• Sắp xếp khóa — đầu ra đẹp với các khóa được sắp xếp theo bảng chữ cái. Tuyệt vời để so sánh diff vì các cấu hình giống hệt nhau sẽ luôn tạo ra đầu ra giống hệt nhau từng byte bất kể thứ tự khóa.

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

TOML là gì và tại sao nên chuyển đổi nó sang JSON?

TOML là một định dạng cấu hình được thiết kế để rõ ràng và tối giản. Chuyển đổi nó sang JSON cho phép bạn đưa cấu hình vào các hệ thống chỉ hỗ trợ JSON, gỡ lỗi cấu trúc lồng nhau một cách trực quan, chia sẻ với các Web API và tích hợp với mã JavaScript mong đợi JSON.

Trình chuyển đổi này có xử lý được mảng các bảng và bảng nội dòng không?

Có. Trình chuyển đổi hỗ trợ đầy đủ cú pháp [[array.of.tables]] (được chuyển đổi sang mảng các đối tượng JSON), bảng nội dòng như { a = 1, b = 2 } (chuyển đổi sang đối tượng JSON), bảng con lồng nhau, khóa dạng chấm và độ sâu lồng nhau tùy ý.

Những kiểu đầu ra nào được hỗ trợ?

Bốn kiểu: Đẹp 2-khoảng-cách (mặc định, lý tưởng để đọc), Đẹp 4-khoảng-cách (khớp với kiểu thụt lề PEP-8), Thu gọn (JSON một dòng đã nén, kích thước nhỏ nhất) và Sắp xếp Khóa (đầu ra đẹp với các khóa được sắp xếp theo bảng chữ cái để dễ so sánh diff).

Các giá trị datetime của TOML được chuyển đổi sang JSON như thế nào?

JSON không có kiểu datetime gốc, vì vậy các giá trị datetime của TOML (định dạng RFC 3339 như 2026-04-25T12:00:00Z) được giữ nguyên dưới dạng chuỗi trong đầu ra JSON. Ngày cục bộ, giờ cục bộ và datetime có độ lệch múi giờ đều được giữ nguyên văn, sẵn sàng để phân tích lại bằng bất kỳ thư viện datetime nào.

Điều gì xảy ra với các giá trị inf và nan của TOML?

JSON tiêu chuẩn không cho phép các giá trị Infinity hoặc NaN, vì vậy các số thực không hữu hạn từ TOML (inf, -inf, nan) được chuyển đổi thành null trong đầu ra JSON. Điều này tạo ra đầu ra tuân thủ nghiêm ngặt RFC 8259 và phân tích chính xác trong mọi thư viện JSON.

Các lỗi phân tích cú pháp đến từ đâu và làm thế nào để khắc phục?

Trình chuyển đổi báo cáo chính xác dòng bị lỗi cùng với mô tả về vấn đề (chuỗi chưa kết thúc, khóa bị trùng lặp, thiếu dấu bằng, mảng sai định dạng, v.v.). Nguyên nhân phổ biến là thiếu dấu ngoặc kép hoặc ngoặc vuông, sử dụng tab ở những nơi không mong muốn và vô tình định nghĩa lại một bảng đã được định nghĩa trước đó.

Có giới hạn kích thước không?

Công cụ có thể xử lý các tệp TOML có kích thước vài megabyte một cách thoải mái. Đối với các tệp cấu hình rất lớn, hiệu suất bị ảnh hưởng chủ yếu bởi việc hiển thị của trình duyệt, không phải bởi việc phân tích cú pháp.

Dữ liệu TOML của tôi có được gửi đi đâu hoặc được lưu trữ không?

Đầu vào của bạn được phân tích cú pháp phía máy chủ để tạo đầu ra JSON và sau đó được hủy bỏ. Chúng tôi không ghi nhật ký, lưu trữ hoặc truyền cấu hình của bạn đi bất kỳ nơi nào khác.

Tôi có thể chuyển đổi JSON ngược lại TOML không?

Công cụ này là một chiều (TOML → JSON). Đối với hướng ngược lại, hãy sử dụng trình chuyển đổi JSON sang TOML hoặc thư viện lập trình như tomli_w của Python, @iarna/toml của JavaScript hoặc crate toml của Rust.

Mẹo để Chuyển đổi Sạch sẽ

• Sử dụng đầu ra sắp xếp khóa để so sánh diff — JSON được kiểm soát phiên bản của bạn sẽ ổn định giữa các thành viên trong nhóm.
• Ưu tiên chuỗi nhiều dòng (""" hoặc ''') cho các đoạn văn bản thay vì nối bằng các ký tự thoát \n.
• Nhóm các khóa liên quan bằng các bảng — chúng dễ đọc hơn các khóa dạng chấm dài.
• Chú ý lỗi vô tình định nghĩa lại bảng — TOML không cho phép định nghĩa cùng một bảng hai lần; trình chuyển đổi sẽ bắt lỗi này với thông báo rõ ràng.
• Giữ ngày và giờ ở định dạng RFC 3339 — các định dạng cục bộ cũng có thể phân tích được, nhưng RFC 3339 giúp việc trao đổi dữ liệu qua JSON được sạch sẽ nhất.

Tài nguyên Bổ sung

• Đặc tả TOML chính thức
• TOML trên Wikipedia
• JSON.org — giới thiệu về JSON
• RFC 8259 — Định dạng Trao đổi Dữ liệu JavaScript Object Notation (JSON)