JSON sang YAML

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

Chuyển đổi JSON sang YAML biến đổi dữ liệu từ JavaScript Object Notation sang YAML Ain't Markup Language. Cả hai định dạng đều biểu diễn cùng một cấu trúc dữ liệu (đối tượng, mảng, chuỗi, số, boolean, null), nhưng sử dụng cú pháp khác nhau. JSON dùng dấu ngoặc nhọn, dấu ngoặc vuông và dấu phẩy. YAML dùng thụt lề và xuống dòng, tạo ra đầu ra gần với văn bản thường hơn. Khác với XML, cả hai định dạng đều không yêu cầu schema.

YAML được thiết kế như một định dạng tuần tự hóa dữ liệu thân thiện với con người. Đây là ngôn ngữ cấu hình mặc định cho Kubernetes manifests, Docker Compose files, Ansible playbooks, GitHub Actions workflows và nhiều hệ thống CI/CD khác. Khi dữ liệu nguồn ở dạng JSON nhưng hệ thống đích yêu cầu YAML, bạn cần một bộ chuyển đổi bảo toàn chính xác từng giá trị, kiểu dữ liệu và cấp độ lồng nhau mà không mất dữ liệu.

Chuyển đổi JSON sang YAML trực tuyến hữu ích khi bạn nhận phản hồi API hoặc dữ liệu xuất ở dạng JSON và cần dán vào file cấu hình YAML. Việc chuyển đổi không mất dữ liệu với mọi kiểu JSON chuẩn: chuỗi, số, boolean, null, mảng và đối tượng đều ánh xạ trực tiếp sang tương đương trong YAML. Các giá trị chứa dấu hai chấm hoặc ký tự đặc biệt sẽ được tự động đặt trong dấu ngoặc kép để đảm bảo đầu ra là YAML hợp lệ.

Tại sao cần chuyển đổi JSON sang YAML?

YAML là chuẩn cho file cấu hình; JSON là thứ API trả về. Chuyển đổi giữa hai định dạng cho phép bạn dùng đúng định dạng cho từng nhiệm vụ mà không cần viết lại dữ liệu thủ công.

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

So sánh JSON và YAML

JSON và YAML có thể biểu diễn cùng một dữ liệu, nhưng cú pháp và tính năng của chúng khác nhau theo những cách quan trọng cho các trường hợp sử dụng cụ thể.

Những điểm dễ mắc lỗi trong YAML sau khi chuyển đổi

YAML có các quy tắc phân tích cú pháp khiến nhiều lập trình viên quen JSON bất ngờ. Bốn vấn đề sau gây ra nhiều lỗi nhất khi làm việc với đầu ra đã chuyển đổi.

Ví dụ mã nguồn

Chuyển đổi JSON sang YAML theo lập trình đòi hỏi thư viện tuần tự hóa YAML trong hầu hết các ngôn ngữ. Thư viện chuẩn xử lý phân tích JSON; đầu ra YAML cần thêm một package.

import YAML from 'js-yaml'

const json = '{"host":"localhost","port":3000,"debug":true}'
const obj = JSON.parse(json)
const yamlStr = YAML.dump(obj, { indent: 2 })
console.log(yamlStr)
// → host: localhost
// → port: 3000
// → debug: true

import json, yaml

json_str = '{"host": "localhost", "port": 3000, "debug": true}'
data = json.loads(json_str)
yaml_str = yaml.dump(data, default_flow_style=False, sort_keys=False)
print(yaml_str)
# → host: localhost
# → port: 3000
# → debug: true

package main

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

func main() {
    jsonStr := `{"host":"localhost","port":3000,"debug":true}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    yamlBytes, _ := yaml.Marshal(data)
    fmt.Println(string(yamlBytes))
    // → debug: true
    // → host: localhost
    // → port: 3000
}

# Using yq (https://github.com/mikefarah/yq)
echo '{"host":"localhost","port":3000}' | yq -P
# → host: localhost
# → port: 3000

# Using Python one-liner
echo '{"host":"localhost","port":3000}' | python3 -c "import sys,json,yaml; print(yaml.dump(json.load(sys.stdin), default_flow_style=False))"

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