YAML sang JSON

Chuyển đổi YAML sang JSON là gì?

Chuyển đổi YAML sang JSON biến đổi dữ liệu được viết bằng YAML (YAML Ain't Markup Language) thành JSON (JavaScript Object Notation). Cả hai định dạng đều biểu diễn dữ liệu có cấu trúc dưới dạng cặp khóa-giá trị, chuỗi và đối tượng lồng nhau, nhưng cú pháp khác nhau. YAML dùng thụt lề và dấu câu tối giản, trong khi JSON dùng dấu ngoặc nhọn, dấu ngoặc vuông và dấu nháy bắt buộc. Chuyển đổi giữa hai định dạng là tác vụ thường gặp khi di chuyển dữ liệu cấu hình giữa các hệ thống yêu cầu định dạng khác nhau.

YAML được thiết kế để con người dễ đọc. Nó hỗ trợ ghi chú, chuỗi nhiều dòng, anchor và alias — những tính năng không tồn tại trong JSON. Khi chuyển đổi YAML sang JSON, các tính năng đặc thù của YAML được giải quyết: anchor được mở rộng tại chỗ, ghi chú bị loại bỏ, và các khối nhiều dòng trở thành chuỗi đã được thoát ký tự. Đầu ra là JSON hợp lệ mà bất kỳ bộ phân tích JSON nào cũng có thể đọc được.

Đặc tả YAML 1.2 định nghĩa rõ ràng JSON là tập con của YAML, 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 đúng. Các tài liệu YAML có ghi chú, anchor hoặc khóa phức tạp không có tương đương trực tiếp trong JSON và phải được đơn giản hóa trong quá trình chuyển đổi. Công cụ này xử lý việc chuyển đổi đó tự động, tạo ra JSON sạch và có định dạng tốt từ bất kỳ đầu vào YAML hợp lệ nào.

YAML 1.2 Specification — yaml.org →

Tại sao sử dụng công cụ chuyển đổi YAML sang JSON online?

Chuyển đổi YAML sang JSON bằng tay rất dễ gây lỗi, đặc biệt với các cấu trúc lồng nhau sâu hoặc giá trị nhiều dòng. Công cụ chạy trên trình duyệt cho kết quả tức thì và phát hiện lỗi cú pháp YAML trước khi chúng đến ứng dụng của bạn.

Các trường hợp sử dụng YAML sang JSON

Tài liệu tham khảo ánh xạ kiểu dữ liệu YAML sang JSON

Mỗi kiểu dữ liệu YAML ánh xạ sang một kiểu JSON cụ thể trong quá trình chuyển đổi. Bảng dưới đây cho thấy từng cấu trúc YAML cùng với đầu ra JSON tương ứng. Hiểu các ánh xạ này giúp bạn dự đoán dữ liệu YAML sẽ trông như thế nào sau khi chuyển đổi và tránh bất ngờ với các kiểu như boolean hoặc giá trị null.

Cú pháp YAML và JSON

YAML và JSON biểu diễn cùng một mô hình dữ liệu nhưng với các quy tắc cú pháp khác nhau. Những khác biệt dưới đây giải thích tại sao một số tính năng YAML — như ghi chú và anchor — không có tương đương trong JSON.

Ví dụ code

Dưới đây là các ví dụ thực tế để chuyển đổi YAML sang JSON theo chương trình. Mỗi ví dụ phân tích một chuỗi YAML và xuất ra JSON đã định dạng.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

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