يمكن أن يمثل JSON وYAML نفس أنواع البيانات (الكائنات والمصفوفات والسلاسل والأرقام)، لكن تركيبهما يختلف: • يستخدم JSON الأقواس/الأقواس وعلامات الاقتباس المزدوجة، وله بناء جملة أكثر صرامة، ولا يدعم التعليقات. • يستخدم YAML المسافة البادئة للتسلسل الهرمي، وهو أكثر قابلية للقراءة من قبل الإنسان، ويدعم التعليقات، ولكنه حساس للمسافات البيضاء. القاعدة الأساسية: • بالنسبة لواجهات برمجة التطبيقات (API) وتبادل البيانات من جهاز إلى جهاز، يفضل JSON. • بالنسبة لتكوينات Kubernetes/Helm/CI التي يقوم البشر بتحريرها كثيرًا، تفضل YAML. • يمكنك التحويل بينهما دون تغيير نموذج البيانات.

يأتي هذا من سلوك YAML 1.1 القديم، حيث قد يتم تحليل نعم/لا/تشغيل/إيقاف/y/n كقيم منطقية. تتبع هذه الأداة YAML 1.2، حيث تكون القيم المنطقية صواب/خطأ فقط. إذا كنت بحاجة إلى قيم سلسلة، فاقتبسها (على سبيل المثال، "yes").

JSON (RFC 8259) لا يسمح بالتعليقات. لذلك لا يمكن الحفاظ على تعليقات YAML في تحويل YAML → JSON، ولا يمكن إعادة بنائها عند التحويل مرة أخرى. احتفظ بملف YAML الأصلي إذا كانت التعليقات مهمة.

--- هو فاصل المستندات الخاص بـ YAML، والذي يستخدم لتخزين عدة مستندات مستقلة في ملف واحد. يعد هذا أمرًا شائعًا في Kubernetes، حيث يمكن أن يحتوي ملف واحد على تعريفات النشر والخدمة وConfigMap. تقرأ هذه الأداة YAML متعدد المستندات كمصفوفة JSON، ويمكنها أيضًا تقسيم مصفوفة JSON مرة أخرى إلى --- مستندات YAML منفصلة.

تستخدم JavaScript أرقام IEEE 754 مزدوجة الدقة. تتراوح الأعداد الصحيحة الآمنة من -(2^53-1) إلى 2^53-1 (±9007199254740991). قد تفقد الدقة الأعداد الصحيحة الأكبر (على سبيل المثال، معرفات Snowflake أو الطوابع الزمنية 64 بت). للحفاظ على القيم الدقيقة، قم بتخزينها كسلاسل، مثل "9007199254740992".