عندما لا يعمل شيء ما · البرمجة مع مارتن

فصل الإنقاذ. يتعثر كل مبرمج أحياناً – حتى أفضلهم. إليك ما يجب فعله.

أولاً، أهم شيء

عندما لا يعمل شيء ما، ليس خطأك ولم تُفسد شيئاً. التعثر جزء طبيعي تماماً من البرمجة. المبرمجون المحترفون يتعاملون مع الأخطاء كل يوم – الفرق الوحيد أنهم تعلّموا البحث عنها بهدوء.

القاعدة الذهبية: اقرأ بعناية

90% من أخطاء الكود هي أخطاء إملائية. أجهزة الكمبيوتر دقيقة جداً:

<h1> يعمل، <hl> لا (الرقم واحد مقابل حرف L صغير)
index.html يعمل، index. html لا (مسافة زائدة)
كل وسم فتح <p> يحتاج وسم إغلاق </p> خاصاً به

قارن كودك بالكود في الدرس حرفاً بحرف. ستجد الخطأ عادةً خلال دقيقة.

مشاكل شائعة وكيف تصلحها

”يفتح كنص عادي، وليس كصفحة”

ملفك على الأرجح ليس اسمه index.html، بل شيء مثل index.html.txt. في VS Code، احذف الملف وأنشئ واحداً جديداً – الاسم يجب أن ينتهي بالضبط بـ .html.

”غيّرت الكود، لكن لا شيء تغيّر في الصفحة”

سببان الأكثر شيوعاً:

نسيت الحفظ – اضغط Ctrl+S (Cmd+S على Mac). الملف غير المحفوظ له نقطة بجانب اسمه في VS Code بدلاً من X.
نسيت تحديث الصفحة – اضغط F5 في متصفحك.

”رموز غريبة في الصفحة بدلاً من الحروف المشكّلة”

رأس ملفك يفتقد السطر <meta charset="UTF-8">. أضفه بين <head> و</head> – يخبر المتصفح بمجموعة الأحرف التي يستخدمها نصك.

”الصورة لا تظهر، فقط أيقونة صورة مكسورة”

تحقق من اسم الملف في كودك – يجب أن يكون نفس الاسم بالضبط كاسم الملف في مجلدك، بما في ذلك الامتداد (photo.jpg ليس مثل photo.JPG أو photo.jpeg).
الصورة يجب أن تكون في نفس مجلد index.html (أو في مسار المجلد الذي كتبته في الكود، مثل images/photo.jpg).

”فجأة نصف الصفحة عريض / كبير / أزرق”

في مكان ما نسيت وسم إغلاق. مثلاً، <strong> يفتقد </strong>، فيبقى كل شيء عريضاً حتى النهاية. ابحث عن حيث يبدأ الغريب وأضف وسم الإغلاق الناقص.

عندما تبقى عالقاً

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

💡

تذكّر: كل خطأ تصلحه يجعلك مبرمجاً أفضل. إصلاح الأخطاء ليس عبئاً، بل قوة خارقة تبنيها الآن.