تفاوت JSON، YAML و XML و انتخاب قالب مناسب

یک داده، سه شکل

{
  "name": "خط وب",
  "tools": ["seo", "image"],
  "active": true
}

name: خط وب
tools:
  - seo
  - image
active: true

<site>
  <name>خط وب</name>
  <tools>seo</tools>
  <tools>image</tools>
  <active>true</active>
</site>

مقایسه

کدام را کجا استفاده کنیم؟

• JSON: ارتباط مرورگر و سرور و API. تقریباً همه‌ی زبان‌ها پشتیبانی می‌کنند.
• YAML: فایل‌هایی که انسان می‌نویسد و می‌خواند: Docker Compose، GitHub Actions، Kubernetes.
• XML: وقتی استاندارد یا سرویس آن را الزام می‌کند (RSS، sitemap، سرویس‌های سازمانی)، یا وقتی ساختار سند با ویژگی‌ها لازم است.

خطاهای رایج

JSON

• ویرگول اضافه بعد از آخرین عضو
• نقل‌قول تکی به‌جای دوتایی
• نداشتن نقل‌قول دور کلید
• توضیح نوشتن (مجاز نیست)

YAML

• ترکیب تب و فاصله در تورفتگی (فقط فاصله مجاز است)
• تورفتگی ناهمگون که ساختار را بی‌صدا عوض می‌کند
• کلید تکراری، که ابزار ما خطا حساب می‌کند
• مقدارهایی مثل no یا on که بعضی تجزیه‌گرها بولی می‌گیرند؛ در شک، مقدار را در نقل‌قول بگذارید

XML

• تگی که بسته نشده
• نام عنصر نامعتبر (فاصله یا شروع با عدد)
• نویسه‌های & و < در متن، بدون escape

نکات تبدیل

• XML نوع داده ندارد؛ در تبدیل XML به JSON همه‌ی مقدارها متن می‌مانند تا مقادیری مثل 00123 خراب نشوند.
• ویژگی‌های XML در JSON/YAML با پیشوند @_ نمایش داده می‌شوند.
• لیست‌های JSON در XML به عنصرهای تکراری تبدیل می‌شوند.
• کلیدهای JSON که نام معتبر XML نیستند اصلاح می‌شوند: فاصله و نمادها به _ تبدیل و کلید شروع‌شده با عدد با _ پیشوند می‌گیرد. کلیدهای فارسی معتبرند و می‌مانند.

برای تبدیل مطمئن و دیدن محل خطا از ابزار تبدیل داده استفاده کنید؛ همه‌چیز در مرورگر انجام می‌شود و داده‌ی شما به سرور نمی‌رود.