Chuyển đổi JSON ↔ YAML Hai Chiều

Có. YAML 1.2 là superset nghiêm ngặt của JSON, nghĩa là mọi tài liệu JSON hợp lệ đều là YAML hợp lệ. Chiều ngược lại không phải lúc nào cũng đúng: các tính năng YAML như chú thích, neo và scalar khối không có tương đương trong JSON.

YAML phổ biến nhất trong các file cấu hình: Docker Compose (docker-compose.yml), manifests Kubernetes, GitHub Actions (.github/workflows), playbooks Ansible. Phong cách dễ đọc phù hợp với các file mà developer chỉnh sửa thủ công.

YAML thường thắng cho cấu hình được con người chỉnh sửa vì nó hỗ trợ chú thích và ít ồn ào hơn về mặt thị giác. JSON tốt hơn cho cấu hình được tạo ra hoặc tiêu thụ bởi máy móc. Nhiều công cụ (ESLint, Prettier, tsconfig) chấp nhận cả hai.

Chuỗi chứa dấu hai chấm theo sau dấu cách, các ký tự đặc biệt ở đầu ({, [, #) hoặc các giá trị trông giống boolean hoặc số phải được đặt trong dấu ngoặc kép. Dấu ngoặc đơn vô hiệu hóa tất cả escape; dấu ngoặc kép sử dụng escape dấu gạch chéo ngược tương tự JSON. Công cụ này tự động thêm dấu ngoặc kép khi cần thiết.

Đối với các kiểu mà JSON hỗ trợ (chuỗi, số, boolean, null, đối tượng, mảng), việc chuyển đổi không mất dữ liệu. Vấn đề tiềm ẩn duy nhất là suy luận kiểu của YAML trên các giá trị không có dấu ngoặc kép, đó là lý do tại sao công cụ này đặt dấu ngoặc kép quanh các chuỗi có thể bị hiểu sai.

Sử dụng thư viện PyYAML: import yaml, json; data = yaml.safe_load(open('file.yaml')); print(json.dumps(data, indent=2)). Hàm safe_load tránh thực thi các thẻ YAML tùy ý, điều này quan trọng cho bảo mật.

Với gói js-yaml: const yaml = require('js-yaml'); const obj = JSON.parse(fs.readFileSync('file.json')); console.log(yaml.dump(obj)). Với cách tiếp cận không phụ thuộc, hãy viết serializer YAML thủ công — đó là những gì công cụ này làm.

Công cụ này cố ý bỏ qua các tính năng YAML nâng cao: neo (&neo), bí danh (*bí danh), thẻ kiểu (!!int, !!str), scalar khối nhiều dòng (| và >), dấu phân cách tài liệu (---). Chúng bao gồm dưới 5% YAML thực tế. Đối với các trường hợp đó, hãy sử dụng thư viện YAML đầy đủ.