تعلّم

إصلاح خطأ "No such file or directory" في Arduino

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
‏Arduino Uno: حساس DHT11 على الطرف 2، جاهز للتعطيلمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
يطبع درجة الحرارة والرطوبة كل ثانيتين. افتحه، اكتب DHT.h بشكل خاطئ، واضغط «تشغيل» لترى الخطأ.

خطأ fatal error: DHT.h: No such file or directory يعني أن سطر #include يذكر اسم ملف ترويسة لا يستطيع المترجم إيجاده في أي مجلد يبحث فيه. عادةً تكون المكتبة التي توفره غير مثبتة، أو أن الاسم في #include مكتوب بشكل مختلف عن الملف. ثبّت المكتبة، أو صحّح الاسم، ويختفي الخطأ. الخطأ قاتل (fatal)، لذلك يتوقف البناء عند أول ترويسة مفقودة ولا يقول شيئًا عن الأسطر التي بعدها.

يجري Mokxi الترجمة باستخدام clang، الذي يعرض الخطأ بالصيغة 'DHT.h' file not found. الدائرة أعلاه هي حساس DHT11 موصول بالطرف 2 في لوحة Uno، ويبدأ كودها بالسطر #include <DHT.h>؛ اضغط «تشغيل» وسيطبع "temperature 22 C, humidity 45 %" كل ثانيتين. افتحها، غيّر السطر إلى #include <DTH.h> واضغط «تشغيل»: يتوقف البناء بخطأ 'DTH.h' file not found، وتقول لوحة البناء إن DTH.h ليست من المكتبات المدمجة في Mokxi وتقترح البحث عنها في Arduino Library Manager.

المكتبة غير مثبتة

الترويسة تأتي من مكتبة، والمكتبة يجب تثبيتها قبل أن يتمكن أي كود من تضمينها. في Arduino IDE، افتح Library Manager (من Sketch، ثم Include Library، ثم Manage Libraries)، وابحث باسم الترويسة أو اسم القطعة، وثبّت المكتبة التي استخدمها الشرح. ملف DHT.h يأتي من مكتبة Adafruit المسماة "DHT sensor library"، التي تحتاج أيضًا إلى "Adafruit Unified Sensor"؛ ويقترح Library Manager تثبيت الاثنتين معًا.

يضم Mokxi المكتبات الشائعة مدمجة بأسمائها المعتادة، لذا فإن DHT.h وServo.h وLiquidCrystal_I2C.h وAdafruit_SSD1306.h وArduinoJson.h وFastLED.h وKeypad.h كلها تُبنى كما هي على لوحة Uno. قائمة المكتبات المدمجة، في لوحة الكود، تعرضها جميعًا. أما الترويسة التي لا يملكها، فتقول لوحة البناء: "ثبّتها من Arduino Library Manager (زر Install، أو بحث Arduino Library Manager أسفل الكود)، أو استخدم Add library لرفع ملف ‎.zip‎ الخاص بها أو ملفات ‎.h‎ و‎.cpp‎ الخاصة بها".

لأن الخطأ قاتل (fatal)، فإن كودًا يضم ترويستين مفقودتين يبلغ عن الأولى فقط. كود يضم #include <NoSuchLib.h> و#include <OtherLib.h> توقف بخطأ واحد، عن NoSuchLib.h؛ ثبّت تلك وسيظهر الخطأ التالي.

الاسم مكتوب بشكل مختلف عن الملف

يجب أن يذكر #include اسم الملف، لا اسم المكتبة. مكتبة "LiquidCrystal I2C" ترويستها هي LiquidCrystal_I2C.h، بشرطة سفلية: السطر #include <LiquidCrystal I2C.h> لا يُوجد، وكذلك #include <LiquidCrystal_I2C> بدون .h. افتح المثال الخاص بالمكتبة نفسها (من File، ثم Examples في بيئة التطوير) وانسخ سطر #include الخاص به.

الحروف الكبيرة تعتمد على الحاسوب. في Linux، أسماء الملفات حساسة لحالة الأحرف، وservo.h ليست Servo.h؛ أما Windows وmacOS فيجدان الملف عادةً بأي طريقة، ولهذا قد يُبنى الكود على حاسوب ويفشل على آخر. يجد Mokxi كلًّا من servo.h وdht.h وwire.h كـ Servo.h وDHT.h وWire.h، لكن اكتبها بالطريقة التي تكتبها بها المكتبة، حتى يُبنى الكود في كل مكان.

الترويسة تخص لوحة أخرى

بعض الترويسات تأتي مع نواة اللوحة نفسها لا مع مكتبة، ولا توجد إلا لتلك اللوحة. WiFi.h وHTTPClient.h تخص لوحات ESP32، وESP8266WiFi.h تخص ESP8266، وavr/io.h تخص شرائح AVR في لوحات Uno وNano وMega. إذا أدرجت إحداها في لوحة لا تمتلكها فلن يتم العثور عليها، مهما كان عدد المكتبات المثبّتة. في Arduino IDE، اختر اللوحة التي كُتب الكود لأجلها (Tools ثم Board)، بعد إضافة حزمة اللوحة الخاصة بها في Boards Manager.

في Mokxi اللوحة الموجودة في الدائرة هي اللوحة التي يُبنى الكود من أجلها، وتذكر تبويبة البناء اللوحات التي يناسبها كل ترويسة. الترويسة #include <WiFi.h> على لوحة Uno قالت إن WiFi.h "يحتاج إلى لوحة تدعم الواي فاي، و Arduino Uno لا تدعم ذلك، على اللوحة الحقيقية أيضًا"، ثم ذكرت اللوحات التي يحاكي عليها Mokxi الواي فاي ومكان التبديل. بعض الترويسات القليلة توقف البناء برسالة خاصة بها بدلًا من ذلك: ESP8266WiFi.h على Uno تقول "هذه اللوحة لا تحتوي على شبكة محاكاة في Mokxi"، و SoftwareSerial.h على ESP32-C3 تقول إنها "مخصصة للوحات AVR (Uno و Nano و Pro Mini و Mega و Leonardo و Pro Micro) و ESP8266 و ESP32 و ESP32-S3 في Mokxi".

علامتا اقتباس أو قوسا زاوية

الترويسة #include <DHT.h>، بالأقواس الزاوية، تبحث في المكتبات المثبّتة والنواة. أما #include "config.h"، بعلامتي الاقتباس، فتبحث أولًا في مجلد الكود نفسه ثم في الأماكن نفسها. علامتا الاقتباس لملف هو تبويبة من تبويبات الكود، مثل config.h أو arduino_secrets.h الذي تحفظ فيه بعض الأمثلة إعداداتها. عندما لا تُنسخ تلك التبويبة مع الكود، يفشل التضمين، وتقول تبويبة البناء في Mokxi "لا يوجد في هذا المشروع ملف باسم config.h" و "أضف ملفًا باسم config.h إلى مشروعك"، مع زر إضافة تبويبة config.h ينشئها.

المكتبة بين علامتي اقتباس تعمل أيضًا، لأن البحث يمتد إلى المكتبات: الترويسة #include "Servo.h" تمت ترجمتها على Uno. الأقواس الزاوية للمكتبات وعلامتا الاقتباس لتبويباتك الخاصة هي الطريقة المعتادة، وهي تخبر القارئ التالي بمكان البحث.

Arduino.h غير موجود خارج Arduino IDE

الخطأ fatal error: Arduino.h: No such file or directory في PlatformIO أو ESPHome يعني أن المشروع ليس معدًّا للبناء مع نواة Arduino أصلًا. في PlatformIO، السطر framework = arduino في platformio.ini هو ما يجلبها. أما في Arduino IDE وفي Mokxi فالنواة موجودة دائمًا.

افتح هذه الدائرة في المحرر. Arduino Uno: حساس DHT11 على الطرف 2، جاهز للانقطاع، موصّل كما يعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله مرة أخرى.

افتح الدائرة

الأسئلة

كيف أصلح الخطأ "DHT.h: No such file or directory"؟

ثبّت مكتبة Adafruit "DHT sensor library" من مدير المكتبات، ومكتبة "Adafruit Unified Sensor" عندما يطلبها الـ IDE. في Mokxi، ملف DHT.h مدمج.

كيف أصلح الخطأ "LiquidCrystal_I2C.h: No such file or directory"؟

ثبّت مكتبة LiquidCrystal I2C من مدير المكتبات، وتأكد من أن #include مكتوبة LiquidCrystal_I2C.h، بالشرطة السفلية وامتداد ‎.h. في Mokxi هي مدمجة.

هل الخطأ "file not found" هو نفس الخطأ؟

نعم. هذه صياغة clang؛ أما GCC، الذي يستخدمه Arduino IDE، فيقول "No such file or directory". يترجم Mokxi باستخدام clang، لذا تعرض تبويبة البناء كلمات clang.

لماذا يشكو من ترويسة واحدة فقط عندما تنقص اثنتان؟

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

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.