قراءة أخطاء المترجم

تتميز أخطاء المترجم في Zig بالدقة وسهولة الفهم. بدلًا من الخوف منها، تعلّم قراءتها؛ فهي غالبًا ما تشير مباشرةً إلى الحل.

يبدأ خطأ Zig باسم الملف ورقم السطر والعمود، ثم الرسالة. ويخبرك ذلك الموضع تحديدًا بمكان البحث أولًا.

أسفل الرسالة، تطبع Zig السطر الذي يحتوي على الخطأ وتضع مؤشرًا أسفل الموضع الدقيق. فتتجه عيناك مباشرةً إلى المشكلة.

تتعامل Zig مع المتغير المحلي أو عملية الاستيراد غير المستخدمة بوصفها خطأ، لا تحذيرًا. وهذا يحافظ على نزاهة الكود دون روابط غير فعالة متروكة.

إذا أردت فعلًا تجاهل قيمة، فأسندها إلى _، وهو معرّف التجاهل. ويخبر ذلك Zig بأن القيمة غير المستخدمة مقصودة.

عندما تتعارض الأنواع، تسمي Zig النوع المتوقَّع والنوع الموجود معًا. وتكشف قراءتهما جنبًا إلى جنب عن التحويل الذي أغفلته.

بعد وقوع خطأ، قد تطبع Zig أسطر ملاحظة. وتشرح هذه التلميحات الإضافية تفاصيل ذات صلة، مثل موضع التصريح عن النوع أول مرة.

قد يتسبب خطأ واحد في ظهور عدة رسائل. أصلح الخطأ الأول وأعد الترجمة، فغالبًا ما تختفي شكاوى كثيرة لاحقة من تلقاء نفسها.

تظهر هذه الرسائل في وقت الترجمة، قبل تشغيل برنامجك أصلًا. واكتشاف الأخطاء مبكرًا هو بالضبط سبب صرامة Zig.

بالنسبة إلى المشكلات الأعمق، تعرض Zig أثر مراجع يوضح كيفية وصول المترجم إلى الكود المعيب، مثل مسار استدعاءات يعود إلى السبب.

اقرأ دائمًا كتلة الخطأ من الأعلى إلى الأسفل. يذكر العنوان المشكلة، بينما تشرح الملاحظات والأثر أدناه سببها.

أبلغت Zig عن متغير محلي غير مستخدم، لكنك قصدت تجاهله. ما الإصلاح الاصطلاحي لذلك؟

يمكنك الآن فهم أخطاء Zig: اقرأ الموضع والمؤشر، وأصلح الخطأ الأول، واستخدم الملاحظات للسياق، وتجاهل القيمة باستخدام الشرطة السفلية عند الحاجة. ✅