Sửa JSON

Đề xuất Liên quan

Sửa JSON (JSON Repair) là gì?

Trường hợp sử dụng

• Làm sạch đầu ra AI/LLM: chuyển đổi một cú nhấp JSON có bao bọc Markdown, văn bản giải thích và dấu phẩy cuối từ ChatGPT/Claude thành JSON chuẩn
• Gỡ lỗi và khắc phục API: khi phản hồi API bị cắt do sự cố cổng hoặc mạng, nhanh chóng bổ sung ngoặc và chuỗi để xác định cấu trúc dữ liệu gốc
• Literal đối tượng JavaScript sao chép từ console: sửa toàn diện nháy đơn, dấu phẩy cuối và khóa không nháy
• Làm sạch tệp cấu hình: xóa chú thích khỏi JSON5/JSONC để có JSON chuẩn, sẵn sàng kết nối thống nhất với dịch vụ hạ nguồn
• Sửa dữ liệu nhật ký và clipboard: nhanh chóng chuẩn hóa các đoạn JSON chứa chú thích, khoảng trắng đặc biệt hoặc bị cắt
• Tiền xử lý di chuyển dữ liệu và script: thêm bước sửa trong pipeline di chuyển dữ liệu để ngăn một vài JSON không hợp lệ chặn toàn bộ lô ETL

Cách Sử dụng

1. Dán nội dung JSON có lỗi, được bao bọc Markdown hoặc bị cắt vào hộp nhập bên trái, hoặc nhấp 'Mẫu' để tải một JSON hỏng điển hình, hoặc tải lên tệp .json/.txt
2. Công cụ tự động phát hiện và sửa các vấn đề cú pháp phổ biến; khu vực đầu ra bên phải hiển thị JSON chuẩn đã định dạng và số lượng từng loại vấn đề đã sửa
3. Nếu vẫn còn thông báo lỗi màu đỏ, bạn có thể chỉnh sửa thủ công trong khu vực nhập và kích hoạt lại sửa (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Sau khi xác nhận cấu trúc chính xác, nhấp 'Sao chép' để đưa kết quả sửa vào clipboard, hoặc nhấp 'Tải xuống' để lưu thành repaired.json để tiếp tục định dạng, xác thực, v.v.

Tính năng

• Bao phủ 7 loại lỗi cú pháp phổ biến: dấu phẩy cuối, nháy đơn, khóa không nháy, chuỗi chưa đóng, chú thích, thiếu ngoặc, bao bọc khối mã Markdown
• Tối ưu làm sạch đầu ra AI: tự động xóa bao bọc ```json và văn bản giải thích bên ngoài khối mã, nhận diện đầu ra điển hình của ChatGPT, Claude, Gemini và các LLM khác
• Tương thích JSON5/JSONC: phân tích cú pháp mở rộng bao gồm chú thích, nháy lỏng và khoảng trắng đặc biệt (như ký tự Unicode vô hình)
• Hoàn thiện thông minh JSON bị cắt: xử lý phản hồi API bị cắt và thiếu ngoặc đóng bằng cách tự động thêm ngoặc và nháy bị thiếu
• Trực quan hóa vấn đề sửa: tự động thống kê và hiển thị số lần mỗi loại vấn đề được sửa, thuận tiện cho kiểm tra và xem xét thủ công
• Xử lý cục bộ bảo vệ quyền riêng tư: phân tích, sửa và định dạng đều diễn ra trong trình duyệt, nội dung đầu vào không gửi đến bất kỳ máy chủ nào
• Chuyển tiếp liền mạch sang định dạng: JSON chuẩn đã sửa có thể chuyển trực tiếp sang Định dạng JSON, Xác thực Schema, tạo mã và các quy trình tiếp theo
• Tải tệp và mẫu: hỗ trợ tải lên tệp .json/.txt hoặc nhấp tải mẫu để nhanh chóng xác minh hiệu quả sửa

Ví dụ mã

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // trailing comma + comment
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Still unrepairable:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // trailing comma + comment
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# Xóa dấu phẩy cuối khỏi đối tượng/mảng (tùy chọn khẩn cấp; KHÔNG xử lý chú thích / nháy đơn)
# Đối với kịch bản phức tạp, sử dụng thư viện chuyên dụng như jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Xác thực đầu ra đã sửa
jq . clean.json >/dev/null && echo 'JSON is valid'

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

Xử lý sự cố

Thuật ngữ

JSON

JavaScript Object Notation, định dạng trao đổi dữ liệu nhẹ dựa trên cặp khóa-giá trị, được định nghĩa trong RFC 8259. Tiêu chuẩn thực tế cho REST API, tệp cấu hình và nhật ký.

RFC 8259

Đặc tả JSON chính thức do IETF phát hành, định nghĩa cú pháp nghiêm ngặt của JSON hợp lệ — tất cả khóa phải nằm trong nháy kép, chỉ một số ký tự giới hạn trong chuỗi cần thoát, không cho phép chú thích và dấu phẩy cuối.

JSON.parse

Trình phân tích cú pháp JSON nghiêm ngặt được tích hợp trong JavaScript và trình duyệt hiện đại, tuân theo RFC 8259. Ném SyntaxError trực tiếp khi gặp bất kỳ lỗi cú pháp nào và không thể sửa khoan dung.

JSON5

Cú pháp mở rộng của JSON (không chuẩn), cho phép khóa không nháy, chuỗi nháy đơn, chú thích (// và /* */), dấu phẩy cuối, số thập lục phân, v.v. Dễ viết hơn cho con người nhưng không tương thích với JSON.parse.

JSONC

JSON with Comments, tên gọi chung được các trình soạn thảo như VS Code sử dụng cho tệp cấu hình JSON có chú thích (như tsconfig.json). Thực chất là một bí danh phổ biến của JSON5.

Trailing Comma / Dấu phẩy cuối

Dấu phẩy thừa sau phần tử cuối cùng của đối tượng hoặc mảng. Được phép trong JavaScript nhưng bị cấm bởi tiêu chuẩn JSON — lỗi cú pháp phổ biến nhất từ đầu ra LLM và sao chép console.log().

Khối mã Markdown

Đoạn mã được bao bọc bởi ba dấu backtick (```). LLM thường tự động bao bọc đầu ra JSON trong ```json ... ```; dán trực tiếp vào JSON.parse() sẽ thất bại.

Tolerant Parser / Trình phân tích khoan dung

Trình phân tích cú pháp có khả năng cố gắng khôi phục và tiếp tục phân tích khi gặp lỗi cú pháp. Công cụ cốt lõi của Sửa JSON, khác với JSON.parse nghiêm ngặt.

SyntaxError

Ngoại lệ lỗi cú pháp được ném bởi JavaScript. Bất kỳ trình phân tích cú pháp JSON nghiêm ngặt nào cũng ném lỗi này khi nhận đầu vào không tuân thủ RFC 8259.

Canonical JSON / JSON chuẩn hóa

JSON được tạo lại qua parse + stringify, với thứ tự khóa ổn định, không có khoảng trắng thừa và 100% tương thích với trình phân tích cú pháp chuẩn. Định dạng đầu ra cuối cùng của công cụ Sửa JSON.

Các loại lỗi Sửa JSON phổ biến và ví dụ

Sửa JSON vs Định dạng JSON vs Xác thực JSON Schema

Authoritative References

• IETFĐặc tả chính thức JSON (RFC 8259)
• MDNJSON.parse - Tài liệu MDN Web
• JSON5JSON5 - Đặc tả cú pháp mở rộng không chính thức
• GitHubjsonrepair (josdejong) - Triển khai tham chiếu cho trình duyệt và Node