خطاهای رایج YAML و رفعشان

پیکربندی یا Mixin را دستی می‌نویسید؟ خطای نحوی YAML جلوی بارگذاری پروفایل را می‌گیرد. خطایتان را با فهرست تطبیق دهید:

خطای ۱: تورفتگی ناهماهنگ (صدرنشین)

# غلط: دو فیلد هم‌سطح با تورفتگی متفاوت
proxies:
  - name: node-A
     type: ss        # یک فاصلهٔ اضافه
# درست: هم‌سطح‌ها دقیقاً تراز؛ فقط فاصله، هرگز Tab

خطاهای امضادار: did not find expected key و mapping values are not allowed. «نمایش نویسه‌های سفید» در ویرایشگر ناجی است.

خطای ۲: بی‌فاصله بعد از دونقطه

port:7890     # غلط — بعد از دونقطه فاصله لازم است
port: 7890    # درست

خطای ۳: نویسهٔ خاص بدون نقل‌قول

password: p@ss:word!   # دونقطه در دل مقدار → ابهام تجزیه
password: "p@ss:word!" # درست: داخل نقل‌قول

گذرواژه‌ها، نام گره‌های ایموجی‌دار و مقادیرِ آغازشده با * (مثل "*.lan" در fake-ip-filter) را همیشه در نقل‌قول بگذارید.

اعتبارسنجی

بعد از ویرایش، پروفایل را در Profiles دوباره انتخاب و Logs را برای خطای تجزیه ببینید؛ یا قطعه را اول در یک اعتبارسنج آنلاین YAML بیازمایید. شمارهٔ خط در خطاها متعلق به پیکربندی ادغام‌شده است — با Mixinِ فعال، با نام فیلد جست‌وجو کنید نه شمارهٔ خط.