پرش به محتوای اصلی

راهنمای تبدیل JSON، YAML، TOML، XML و CSV

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

داده‌ی یکسان در جاهای مختلف قالب‌های مختلفی می‌خواهد: API پاسخ JSON می‌دهد، فایل پیکربندی Kubernetes یا GitHub Actions با YAML نوشته می‌شود، پروژه‌های Rust و Python از TOML استفاده می‌کنند، سامانه‌های قدیمی XML می‌خواهند و صفحه‌گسترده CSV. این ابزار داده را از هر کدام از این پنج قالب به هر قالب دیگر تبدیل می‌کند.

تبدیل در مرورگر شما انجام می‌شود و داده به جایی فرستاده نمی‌شود. اگر ورودی خطای نحوی داشته باشد، پیام خطا به‌جای خروجی نمایش داده می‌شود.

گام‌به‌گام

  1. قالب مبدأ و مقصد را انتخاب کنید

    در بالای دو کادر، قالب ورودی و خروجی را از میان JSON، YAML، TOML، XML و CSV بردارید.

  2. داده را بچسبانید

    ورودی را در کادر سمت ورودی بگذارید؛ خروجی بلافاصله ساخته می‌شود. ورودی تا ۲ مگابایت پذیرفته می‌شود.

  3. خروجی را بررسی کنید

    به یادداشت‌های زیر کادرها توجه کنید: در CSV شیء یا آرایه‌ی داخل یک خانه به شکل متن JSON نوشته می‌شود و ویژگی‌های XML با پیشوند @_ در کلید می‌آیند.

  4. کپی یا دانلود کنید

    خروجی را کپی کنید یا با پسوند درست دانلود کنید، یا با «ارسال به ابزار دیگر» به ابزار بعدی بفرستید.

نمونه‌های کاربردی

  • JSON به YAML

    یک شیء ساده با آرایه به YAML تبدیل می‌شود؛ آرایه با خط تیره و تورفتگی نوشته می‌شود.

    {"name":"علی","tags":["a","b"],"age":30}

    نتیجه: name: علی tags: - a - b age: 30

  • CSV به JSON

    سطر اول نام ستون‌هاست و هر سطر بعدی یک شیء در آرایه می‌شود.

    name,city
    علی,تهران
    سارا,شیراز

    نتیجه: [ { "name": "علی", "city": "تهران" }, { "name": "سارا", "city": "شیراز" } ]

اشتباه‌های رایج

  • انتظار عدد از CSV: در خواندن CSV همه‌ی خانه‌ها رشته‌اند. اگر عدد لازم دارید، پس از تبدیل نوعشان را اصلاح کنید.
  • تبدیل داده‌ی تودرتو به CSV: CSV جدول تخت است؛ شیء‌های داخلی به متن JSON درون یک خانه تبدیل می‌شوند. برای داده‌ی عمیق قالب دیگری انتخاب کنید.
  • تبدیل آرایه‌ی ریشه به TOML: TOML در ریشه به جدول نیاز دارد. داده را داخل یک کلید بگذارید، مثلاً items.
  • تکیه بر نقل‌قول نکردن در YAML: مقدارهایی مثل yes، no یا 0123 ممکن است در برخی خواننده‌های YAML معنای دیگری بگیرند. اگر رشته‌اند، داخل نقل‌قول بنویسید.

کدام قالب برای چه کاری؟

JSON ساده و همه‌جاخوان است و بیشتر برای تبادل داده میان برنامه‌ها به کار می‌رود. YAML و TOML برای فایل‌هایی ساخته شده‌اند که آدم‌ها می‌نویسند و می‌خوانند؛ توضیح‌نویسی را می‌پذیرند و نقل‌قول و آکولاد کمتری دارند. XML قدیمی‌تر است و ویژگی و فضای نام دارد. CSV ساده‌ترین قالب برای جدول است و هر صفحه‌گسترده‌ای آن را باز می‌کند.

تبدیل میان این قالب‌ها همیشه بی‌کم‌وکاست نیست: توضیح‌های YAML در JSON جایی ندارند و CSV ساختار تودرتو را نگه نمی‌دارد. پس از تبدیل، خروجی را یک بار با چشم مرور کنید.

پرسش‌های متداول

ویژگی‌های (attribute) XML چطور نمایش داده می‌شوند؟
با پیشوند «@_» در کلید؛ مثلاً <book id="7"> به کلید «@_id» تبدیل می‌شود و در تبدیل برگشتی دوباره ویژگی می‌شود.
مقدارهای تو در تو در CSV چه می‌شوند؟
CSV جدول تخت است؛ شیء یا آرایه‌ی داخل یک سطر به‌صورت متن JSON در همان خانه نوشته می‌شود. در تبدیل CSV به JSON همه‌ی خانه‌ها رشته می‌مانند.
چرا TOML گاهی خطا می‌دهد؟
TOML مقدار null ندارد و ریشه‌ی آن باید جدول (شیء) باشد؛ آرایه‌ی سطح بالا یا null قابل تبدیل به TOML نیست و خطای فارسی نشان داده می‌شود.

ابزارهای مرتبط