حل المشكلات

أخطاء البناء بكلمات بسيطة

رسائل المترجم التي يقابلها الناس كثيرًا في Mokxi، ومعنى كل واحدة، وماذا تغيّر.

ما تراه

The Build tab under the code shows the compiler's own words. Click a line and the editor jumps to it. The line it names is where the compiler noticed, which is sometimes one line after the real mistake. Mokxi AI's Why won't this compile? and Fix it explain and fix the one in front of you (Mokxi AI). طريقة عمل البناء موجودة في الكود والترجمة.

ابحث عن أول خطأ في تبويب البناء أسفل الكود. أصلح هذا أولًا: خطأ واحد كثيرًا ما يسبب عدة أخطاء بعده.

الأقواس المعقوفة والمربعة والفواصل المنقوطة

  • expected ';' after expression, expected ';' at end of declaration, expected ';' after top level declarator. ينقص السطر ;. أضفه في نهاية السطر المذكور، أو السطر الذي فوقه مباشرة.
  • expected ';' after struct. A struct أو class يجب أن ينتهي بـ };.
  • expected '}'. A { فُتح ولم يُغلق أبدًا. المفقود } عادةً في نهاية loop() أو if داخله. ضع المؤشر بجوار قوس فيعرض المحرر نظيره.
  • extraneous closing brace ('}'). هناك } زائد. احذفه.
  • function definition is not allowed here. الدالة التي فوق لم تُغلق قط، لذا تبدأ هذه داخلها. أضف المفقود } في الأعلى.
  • expected ')'. A ( غير مغلق. عُدّ الأقواس في ذلك السطر.
  • expected '(' after 'if'. تحتاج ++C أقواسًا مربعة حول شرط: if (x > 5)، وليس if x > 5.
  • expected function body after function declarator. عنوان مثل void setup() لا يأتي بعده {.

كود خارج دالة

  • expected unqualified-id. شيء خارج كل الدوال لا يستطيع C++ قراءته: كلمة زائدة، أو ``` سياج نصوص أو سطر "Copy code" لُصق مع الكود، أو سطر ينتمي إلى داخل setup() أو loop(). احذف النص الزائد.
  • a type specifier is required for all declarations, unknown type name 'Serial', while loop outside of a function. استدعاء أو حلقة تقع خارج كل الدوال. انقلها إلى setup() (مرة واحدة) أو loop() (مرارًا وتكرارًا).
  • unknown type name 'cpp'. السطر الأول تسمية منسوخة من محادثة أو صفحة ويب. احذفها، وأي سطر "Copy code" وسياج ``` .
  • unknown type name 'from' أو 'import'. الملف بلغة Python، بينما يُبنى الكود كـ Arduino C++. يقول ذلك لوحة البناء أولًا: "هذا الكود مكتوب بلغة MicroPython وليس Arduino C++". لوحات Raspberry Pi Pico وPico W وESP32 (لوحات DevKit V1 وDevKitC وLOLIN32 Lite وESP32-S3 وESP32-C3 وESP32-C6) تشغّل MicroPython: اختر MicroPython (main.py) في لوحة البرنامج الثابت للوحة وانقل الكود إلى main.py، أو اضغط شغّله كـ MicroPython أسفل الخطأ للقيام بالأمرين معًا. اللوحة التي فيها تبويب main.py وليس فيها .ino تشغّل MicroPython. على أي لوحة أخرى، اكتب البرنامج بلغة C++. انظر MicroPython on the ESP32 و لوحة Pico.
  • invalid preprocessing directive. يبدأ سطر بـ # وكلمة لا يعرفها C++: #incude بدلًا من #includeمثلًا. صحّح التهجئة.
  • invalid suffix 'https' on integer constant. نص لُصق مع الكود انتهى داخل سطر. احذفه، أو ضع // أمامه.

الأسماء

  • undefined symbol: setup() أو undefined symbol: loop(). كل كود يحتاج إلى كل من void setup() { } و void loop() { }بهذه التهجئة بالضبط، حتى لو كانا فارغين. الملف الفارغ يحصل على هذا أيضًا.
  • use of undeclared identifier 'serial'; did you mean 'Serial'?. الأسماء حساسة لحالة الأحرف. استخدم التهجئة الواردة بعد "هل تعني".
  • use of undeclared identifier 'output'. ثوابت Arduino تُكتب بأحرف كبيرة: OUTPUT, INPUT, INPUT_PULLUP, HIGH, LOW.
  • use of undeclared identifier 'LED_PIN'. الاسم غير معرّف أبدًا، وغالبًا لأن الأسطر الأولى من الدرس لم تُنسخ. أضف const int LED_PIN = 13; فوق setup(). متغير تستخدمه دالتان معًا يوضع فوقهما. setup() و loop() الاستخدام يأتي فوقهما كليهما.
  • undefined symbol: blinkTwice(). دالة تُستدعى لكنها لم تُكتب، أو تهجئتها مختلفة، أو كُتبت داخل دالة أخرى. اكتبها في المستوى الأعلى من الكود.
  • redefinition of 'setup'. كودان لُصقا في ملف واحد، أو setup() في تبويبين. أبقِ واحدًا setup() وواحدًا loop() ودمج محتواهما.
  • redefinition of '...' as different kind of symbol. متغير يحمل اسم شيء تملكه اللوحة أصلًا. أعد تسمية المتغير.
  • cannot combine with previous 'int' declaration specifier. نوعان معًا، مثل int int. أبقِ واحدًا.

استدعاءات لا تناسب

  • no matching function for call to 'pinMode'. pinMode يأخذ الطرف والوضع: pinMode(13, OUTPUT). الطرف بين علامتي اقتباس نص وليس رقمًا.
  • no matching member function for call to 'println'. Serial.println يطبع قيمة واحدة. اطبع كل قيمة بأمر Serial.print.
  • no member named 'display' in .... تلك المكتبة لا تتضمن استدعاءً بهذا الاسم: الكود كُتب لمكتبة أو إصدار آخر. المكتبات المدمجة في لوحة الكود يسرد استدعاءات كل مكتبة.
  • expression is not assignable. شيء ليس متغيرًا يقع يسار =، كما في digitalRead(2) = HIGH. للمقارنة، استخدم ==.
  • excess elements in array initializer. عدد القيم داخل الأقواس أكبر من الحجم المحدد بين القوسين المربّعين. اترك القوسين فارغين: int pins[] = {2, 3, 4};
  • member reference base type 'const char *' is not a structure or union. النص العادي لا يحتوي على .length(). استخدم strlen(text)، أو اجعلها String.

ملفات ومكتبات ناقصة

  • 'Something.h' file not found. لا تتوفر هذه المكتبة مدمجة في Mokxi. يذكر تبويب «البناء» اسم المكتبة المدمجة التي تؤدي المهمة نفسها، أو يقترح تثبيت تثبيت من Arduino Library Manager. راجع لم تتم ترجمة الكود.

  • 'config.h' file not found، أو 'secrets.h', 'arduino_secrets.h', 'credentials.h' (اسم بين علامتي اقتباس، أو ملف إعدادات بين علامتي أكبر وأصغر). كان هذا الملف في المشروع الأصلي تبويبًا مستقلًا في Arduino IDE، وغالبًا ما يحمل اسم شبكة WiFi وكلمة المرور أو رمزًا يُبقى خارج الكود، ولم يُنسخ مع المشروع. أضف ملفًا بهذا الاسم بالضبط إلى مشروعك (زر + بجانب التبويبات)، أو اضغط أضف تبويب secrets.h أسفل الخطأ. يحتوي التبويب الجديد على #define مع قيمة مؤقتة لكل إعداد يستخدمه الكود ولا يعرّفه (مثل SECRET_SSID, WIFI_PASSWORD أو BOT_TOKEN)؛ يبدأ اسم شبكة WiFi وكلمة المرور بقيم الشبكة المحاكاة، Mokxi-Lab و breadboard. ضع قيمك في الباقي. إذا كان الملف موجودًا في المشروع بحالة أحرف مختلفة (Secrets.h)، يغيّر الزر #include ليطابقها بدلًا من ذلك.

  • 'wokwi-api.h' file not found، أو التحذير chip.c is a Wokwi custom chip. هذا الكود خاص بشريحة مخصصة من Wokwi، وليس جزءًا من كود اللوحة: تُبنى الشريحة على حدة. يترك Mokxi تبويبًا كهذا خارج بناء اللوحة. لتشغيل الشريحة، استورد المشروع مجددًا مع <name>.chip.json، أو أنشئ واحدة باستخدام المزيد, شريحة مخصصة جديدة والصق الكود في .chip.c. انظر الشرائح المخصصة.

  • 'WiFi.h' file not found على Pico، أو 'WiFiS3.h' على Uno. هذه اللوحة لا تحتوي على WiFi. اختر Pico W أو لوحة ESP32 أو UNO R4 WiFi.

  • This board has no simulated network in Mokxi من مكتبة شبكات مثل WebSocketsClient.h أو PubSubClient.h. هذه اللوحة لا تحتوي على WiFi. اختر لوحة ESP32 أو ESP8266 أو Pico W أو UNO R4 WiFi.

  • 'atomic' file not found على Uno أو Nano أو Mega. لا تتوفر في لوحات AVR مكتبة C++ القياسية، تمامًا كاللوحات الحقيقية. استخدم متغيرًا volatile بدلًا منها.

  • This code is intended to run on the ESP8266 platform!. كود Blynk مخصص لـ ESP8266 على لوحة أخرى. استخدم BlynkSimpleEsp32.h على ESP32، أو BlynkSimpleWifi.h على Pico W. راجع Blynk، محاكى.

  • MIDIUSB can only be used with an USB MCU.. تحتاج MIDIUSB إلى لوحة تكون شريحتها نفسها جهاز USB: مثل Leonardo أو Micro أو Pro Micro. منفذ USB في Uno يعمل عبر شريحة منفصلة. اختر إحدى هذه اللوحات الثلاث، أو أرسل بايتات MIDI عبر منفذ تسلسلي باستخدام MIDI.h. لا تتم محاكاة مضيف USB، لذا لا تذهب رسائل MIDI إلى أي مكان حتى هناك؛ وتذكر الشاشة التسلسلية ذلك مرة واحدة.

  • ملف مكتبة غير موجود داخل مكتبة أضفتها، مثل 'OneWire_direct_regtype.h'. يحمل المشروع نسخته الخاصة من مكتبة متوفرة أصلًا في Mokxi، وهذه النسخة هي التي تُستخدم. احذفها بزر x على شريحتها في شريط المكتبات أسفل الكود.

  • enumeration values 'WStype_PING' and 'WStype_PONG' not handled in switch. هذا تحذير وليس خطأً: تترك أمثلة مكتبة WebSockets بعض أنواع الأحداث خارج switch، ويستمر الكود في العمل رغم ذلك. أضف default: break; لإسكاته. راجع WiFi, simulated لتعرف ما يمكن لعميل WebSockets الوصول إليه هنا.

حدود اللوحة

  • global variables do not fit in the 2 KB SRAM. مصفوفات كبيرة أو نصوص طويلة. صغّرها، أو أبقِ النصوص في الذاكرة الفلاشية باستخدام F("...")، أو اختر لوحة بذاكرة أكبر مثل Mega 2560 أو ESP32.
  • firmware does not fit in the 32 KB flash. حجم البرنامج أكبر من سعة اللوحة. احذف ما لا يحتاجه الكود، أو اختر لوحة أكبر.
  • use of undeclared identifier 'Wire1'. لهذه اللوحة ناقل I2C واحد هنا: استخدم Wire وأعطِ كل جهاز عنوانه الخاص.
  • use of undeclared identifier 'dacWrite'. لوحة ESP32 الكلاسيكية وحدها تحتوي على DAC. استخدم analogWrite، أو اختر ESP32 DevKit.

ما زلت عالقًا

اضغط لماذا لا تتم الترجمة؟ في Mokxi AI، أو راسلنا من /support مع نص الخطأ ورابط المشروع. راجع أيضًا: