Handytool
دليل المطور5 د قراءةمحدث بتاريخ 11 مارس 2026

أداة YAML فوري

نظف YAML وحوله إلى JSON بنقرة واحدة.

ينسق منسق YAML في Handytool المسافة البادئة، والتحقق من صحة الصيغة برسائل خطأ دقيقة، والتحويل بين YAML و JSON — كل شيء في متصفحك بدون تحميل بايت واحد.

النقاط الرئيسية

  • 01ينسق YAML مع مسافة بادئة متسقة باستخدام محلل js-yaml — نفس المكتبة المستخدمة في أدوات بناء Node.js.
  • 02يتحقق من الصيغة ويبلغ عن أرقام الأسطر الدقيقة للأخطاء.
  • 03يحول بين YAML و JSON في كلا الاتجاهين مع الحفاظ على نوع صحيح.
  • 04لا شيء تم تحميله — تعمل العملية الكاملة محلياً في متصفحك.

لماذا يعتبر تنسيق YAML مهماً لملفات الإعدادات

YAML هي لغة الإعدادات الافتراضية لـ Kubernetes و GitHub Actions و Docker Compose و مخططات Helm والعديد من الأدوات الأخرى. كما أنها حساسة جداً لعلى مستوى المسافة البادئة — يمكن لسطر واحد مسافة بادئة خاطئة أن ينتج عدم تطابق نوع صامت أو خطأ تحليل صعب يحظر نشرة. يحافظ التنسيق بانتظام على ملفات متسقة ويمسك بالمشاكل قبل أن تصل إلى CI.

التحويل بين YAML و JSON مفيد بنفس القدر. تقبل بعض الأدوات فقط JSON لمكالمات API أو تعريفات المخطط، بينما يفضل البشر بشكل عام YAML للملفات طويلة المدى. أن تكون قادراً على الاذهاب والإياب بين الاثنين دون فقدان أنواع البيانات — الأرقام تبقى أرقام وأعراض بوليه تبقى أعراض بوليه — يوفر الوقت ويمنع الأخطاء الدقيقة.

كيفية تنسيق أو تحويل YAML

  1. 01

    الصق YAML أو JSON الخاص بك

    الصق بيان Kubernetes أو مسار عمل GitHub Actions أو ملف قيم Helm أو أي مستند YAML آخر. لتحويل JSON إلى YAML، الصق JSON بدلاً من ذلك.

  2. 02

    اختر إجراءً

    حدد تنسيق YAML لتوحيد المسافة البادئة وتنظيف المستند في الموضع. حدد YAML إلى JSON أو JSON إلى YAML لتحويل الصيغة بالكامل.

  3. 03

    راجع الأخطاء إن وجدت

    إذا كان الإدخال يحتوي على خطأ صيغة، تعرض الأداة رقم السطر الدقيق والسبب من محلل js-yaml — نفس المحلل الذي تستخدمه أدوات Node.js، لذا يطابق الخطأ ما ستراه في الإنتاج.

  4. 04

    انسخ الإخراج

    انقر فوق نسخ لالتقاط الإخراج المنسق أو المحول. الصقه مرة أخرى في ملف الإعدادات أو نص API أو تعريف المخطط.

عندما تحفظ هذه الأداة وقتك

  • 01بيان Kubernetes قد انجرف — توحيد المسافة البادئة قبل الالتزام.
  • 02مسار عمل GitHub Actions لا يمكن تحليله — تحقق من الحصول على رقم الخطأ الدقيق.
  • 03API يقبل فقط JSON لكن الإعدادات مخزنة كـ YAML — حول بنقرة واحدة.
  • 04تثقيف خدمة جديدة — حول قيمة JSON إلى YAML لمخطط Helm.
  • 05نسخ YAML من Stack Overflow — أعد تنسيقها لتتطابق مع نمط مسافة بادئة 2 من المشروع.
  • 06تصحيح أخطاء دمج قيم Helm — التحقق من صحة أن كل values.yaml نظيفة بشكل فردي.

خاصة بدون تحميل مطلوب

التنسيق والتحويل يعملان بالكامل في متصفحك باستخدام js-yaml — نفس المكتبة المرفقة في Webpack و Rollup وأدوات بناء JavaScript الأكثر. ملفات الإعدادات وإشارات الأسرار وأسماء متغيرات البيئة لا تترك جهازك.

يستهدف المحلل YAML 1.2، وهو ما تستخدمه Kubernetes و GitHub Actions و Docker Compose. إذا كان ملف يتحقق هنا، فسيحمل بشكل صحيح في تلك الأدوات.

الأسئلة الشائعة حول منسق YAML

هل سيحافظ تنسيق YAML على التعليقات؟

لا. محلل js-yaml يزيل التعليقات أثناء التحليل — هذا حد من جميع محللات JavaScript YAML. نسق أولاً، ثم أضف التعليقات مرة أخرى يدوياً.

أي إصدار YAML يدعم هذا؟

YAML 1.2، وهو الإصدار المستخدم من قبل Kubernetes و GitHub Actions و Docker Compose و Helm. ما يتحقق هنا سيحمل بنظافة في تلك الأدوات.

هل يحافظ التحويل من YAML إلى JSON على الأنواع؟

نعم. الأرقام والأعراض البوليه و null وسلاسل التاريخ تعمل بشكل صحيح. في YAML حقيقي يصبح قيمة منطقية حقيقية في JSON، وليس السلسلة 'true'.

ما الفرق بين التنسيق والتحويل؟

التنسيق يحافظ على الملف كـ YAML ويوحد المساحة البيضاء والمسافة البادئة. التحويل يغير صيغة الإخراج بالكامل — ينتج YAML إلى JSON مستند متوافق مع .json.

YAML الخاص بي يحتوي على عدة مستندات مفصولة بـ ---. هل سيتم معالجة الجميع؟

يتم تحليل وإعادة إصدار المستند الأول. بالنسبة للملفات متعددة الوثائق، قسّم كل قسم في --- ومعالجتها بشكل فردي.

الأدوات ذات الصلة

استمر في العمل مع أدوات المطور

أدوات المطور