ما تراه
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. Astructأو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 مع نص الخطأ ورابط المشروع. راجع أيضًا:
- لم تتم ترجمة الكود: تبويب البناء والمكتبات والأكواد التي تُبنى بنجاح في Arduino IDE.
- المحرر أو المترجم لا يفتح: عندما لا يبدأ البناء أبدًا.
- يشرح أخطاء ترجمة Arduino الرسائل نفسها بصياغة GCC وبصياغة clang.