Khắc phục sự cố

Lỗi biên dịch diễn đạt bằng lời đơn giản

Những thông báo trình biên dịch mọi người gặp nhiều nhất trong Mokxi, ý nghĩa của từng thông báo, và cần thay đổi gì.

Những gì bạn thấy

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). Cách biên dịch hoạt động nằm trong code và biên dịch.

Tìm lỗi đầu tiên trong tab Build phía dưới. Sửa lỗi đó trước: một sai sót thường gây ra nhiều lỗi phía sau.

Dấu ngoặc nhọn, ngoặc vuông và dấu chấm phẩy

  • expected ';' after expression, expected ';' at end of declaration, expected ';' after top level declarator. Một dòng thiếu ;. Thêm nó vào cuối dòng được nêu tên, hoặc dòng ngay phía trên nó.
  • expected ';' after struct. A struct hoặc class phải kết thúc bằng };.
  • expected '}'. A { được mở nhưng không bao giờ được đóng. Dấu } thiếu thường nằm ở cuối loop() hoặc của một if bên trong nó. Đặt con trỏ cạnh một dấu ngoặc và trình soạn thảo sẽ hiện dấu khớp với nó.
  • extraneous closing brace ('}'). Một dấu } thừa. Hãy xóa nó đi.
  • function definition is not allowed here. Hàm phía trên chưa được đóng, nên hàm này bắt đầu bên trong nó. Thêm dấu } còn thiếu vào phía trên.
  • expected ')'. A ( chưa được đóng. Đếm các dấu ngoặc trên dòng đó.
  • expected '(' after 'if'. C++ cần ngoặc quanh một điều kiện: if (x > 5), không phải if x > 5.
  • expected function body after function declarator. Một tiêu đề chẳng hạn như void setup() không đứng sau {.

Code nằm ngoài hàm

  • expected unqualified-id. Một thứ nằm ngoài mọi hàm mà C++ không đọc được: một từ thừa, một ``` hàng rào code hoặc dòng "Copy code" dán theo sketch, hoặc một dòng lẽ ra nằm trong setup() hoặc loop(). Xóa đoạn text thừa.
  • a type specifier is required for all declarations, unknown type name 'Serial', while loop outside of a function. Một lời gọi hàm hoặc vòng lặp nằm ngoài mọi hàm. Chuyển nó vào setup() (một lần) hoặc loop() (lặp đi lặp lại).
  • unknown type name 'cpp'. Dòng đầu là nhãn được sao chép từ đoạn chat hoặc trang web. Xóa nó, cùng dòng "Copy code" và ``` các dấu gạch.
  • unknown type name 'from' hoặc 'import'. Tệp là Python, còn sketch được biên dịch thành Arduino C++. Tab Biên dịch sẽ nói trước: "Sketch này là MicroPython, không phải Arduino C++". Các bo mạch Raspberry Pi Pico, Pico W và ESP32 (bo DevKit V1, DevKitC, LOLIN32 Lite, ESP32-S3, ESP32-C3 và ESP32-C6) chạy MicroPython: chọn MicroPython (main.py) trong bảng Firmware của bo mạch và chuyển code sang main.py, hoặc nhấn Chạy dưới dạng MicroPython bên dưới lỗi để làm cả hai việc. Một bo mạch có tab main.py mà không có .ino chạy MicroPython. Trên bo mạch khác, hãy viết chương trình bằng C++. Xem MicroPython on the ESP32 và Pico.
  • invalid preprocessing directive. Một dòng bắt đầu bằng # và một từ C++ không biết: #incude chẳng hạn #include. Sửa lại chính tả.
  • invalid suffix 'https' on integer constant. Text dán theo code bị lọt vào giữa một dòng. Xóa nó, hoặc đặt // ở phía trước nó.

Tên

  • undefined symbol: setup() hoặc undefined symbol: loop(). Mọi sketch cần cả void setup() { } và void loop() { }, viết đúng chính tả như vậy, ngay cả khi chúng rỗng. Một tệp rỗng cũng gặp lỗi này.
  • use of undeclared identifier 'serial'; did you mean 'Serial'?. Tên phân biệt chữ hoa chữ thường. Dùng cách viết sau "did you mean".
  • use of undeclared identifier 'output'. Hằng số của Arduino viết hoa: OUTPUT, INPUT, INPUT_PULLUP, HIGH, LOW.
  • use of undeclared identifier 'LED_PIN'. Tên chưa từng được định nghĩa, thường vì các dòng đầu của bài hướng dẫn không được sao chép. Thêm const int LED_PIN = 13; phía trên setup(). Một biến được cả setup() và loop() dùng thì đặt phía trên cả hai.
  • undefined symbol: blinkTwice(). Một hàm được gọi nhưng chưa từng được viết, viết sai chính tả, hoặc được viết bên trong một hàm khác. Hãy viết nó ở cấp cao nhất của sketch.
  • redefinition of 'setup'. Hai sketch dán vào một tệp, hoặc setup() trong hai tab. Giữ một setup() và một loop() rồi gộp phần thân của chúng.
  • redefinition of '...' as different kind of symbol. Một biến trùng tên với thứ bo mạch đã có sẵn. Đổi tên biến.
  • cannot combine with previous 'int' declaration specifier. Hai kiểu đứng cùng nhau, chẳng hạn int int. Giữ một.

Lời gọi không phù hợp

  • no matching function for call to 'pinMode'. pinMode nhận chân và chế độ: pinMode(13, OUTPUT). Một chân trong ngoặc kép là text, không phải số.
  • no matching member function for call to 'println'. Serial.println in một giá trị. In từng giá trị bằng Serial.print.
  • no member named 'display' in ...riêng của nó. Thư viện đó không có lời gọi nào tên như vậy: sketch được viết cho thư viện hoặc phiên bản khác. Thư viện có sẵn trong khung code liệt kê các lời gọi của từng thư viện.
  • expression is not assignable. Một thứ không phải biến đứng bên trái =, như trong digitalRead(2) = HIGH. Để so sánh, dùng ==.
  • excess elements in array initializer. Số giá trị trong ngoặc nhọn nhiều hơn kích thước trong ngoặc vuông. Hãy để ngoặc vuông rỗng: int pins[] = {2, 3, 4};
  • member reference base type 'const char *' is not a structure or union. Chữ thường không có .length(). Dùng strlen(text), hoặc biến nó thành String.

Thiếu tệp và thư viện

  • 'Something.h' file not found. Mokxi không có sẵn thư viện đó. Tab Build sẽ nêu tên thư viện có sẵn làm được việc tương tự, hoặc gợi ý Cài từ Arduino Library Manager. Xem sketch không biên dịch được.

  • 'config.h' file not found, hoặc 'secrets.h', 'arduino_secrets.h', 'credentials.h' (tên trong dấu ngoặc kép, hoặc tệp cài đặt trong dấu ngoặc nhọn). Dự án gốc có tệp đó là một tab riêng trong Arduino IDE, thường chứa tên WiFi và mật khẩu hoặc một token được giữ ngoài code, và nó không được sao chép theo. Hãy thêm một tệp với đúng tên đó vào dự án của bạn (dấu + cạnh các tab), hoặc nhấn Thêm tab secrets.h dưới lỗi. Tab mới có một #define với chỗ điền cho mỗi cài đặt mà sketch dùng nhưng không định nghĩa (chẳng hạn SECRET_SSID, WIFI_PASSWORD hoặc BOT_TOKEN); tên WiFi và mật khẩu khởi đầu là của mạng mô phỏng, Mokxi-Lab và breadboard. Hãy điền giá trị của bạn vào phần còn lại. Nếu dự án có tệp đó viết hoa khác (Secrets.h), nút này sẽ đổi #include cho khớp.

  • 'wokwi-api.h' file not found, hoặc cảnh báo chip.c is a Wokwi custom chip. Code đó là của chip tùy chỉnh Wokwi, không nằm trong sketch của bo mạch: chip được xây riêng. Mokxi bỏ tab như vậy khỏi bản build của bo mạch. Để chạy chip, hãy nhập lại dự án cùng với <name>.chip.json, hoặc tạo một cái bằng Thêm, Chip tùy chỉnh mới và dán code vào .chip.c. Xem chip tùy chỉnh.

  • 'WiFi.h' file not found trên Pico, hoặc 'WiFiS3.h' trên Uno. Bo mạch đó không có WiFi. Hãy chọn Pico W, một bo mạch ESP32 hoặc UNO R4 WiFi.

  • This board has no simulated network in Mokxi từ một thư viện mạng như WebSocketsClient.h hoặc PubSubClient.h. Bo mạch đó không có WiFi. Hãy chọn một bo mạch ESP32, ESP8266, Pico W hoặc UNO R4 WiFi.

  • 'atomic' file not found trên Uno, Nano hoặc Mega. Các bo AVR không có thư viện chuẩn C++, giống như trên bo thật. Hãy dùng volatile thay thế.

  • This code is intended to run on the ESP8266 platform!. Một sketch Blynk cho ESP8266 chạy trên bo khác. Dùng BlynkSimpleEsp32.h trên ESP32, hoặc BlynkSimpleWifi.h trên Pico W. Xem Blynk, được mô phỏng.

  • MIDIUSB can only be used with an USB MCU.. MIDIUSB cần một bo có chip làm thiết bị USB riêng: Leonardo, Micro hoặc Pro Micro. USB của Uno là một chip riêng. Hãy chọn một trong ba bo đó, hoặc gửi byte MIDI qua cổng serial bằng MIDI.h. Không mô phỏng USB host, nên các thông điệp MIDI cũng không đi tới đâu cả; Serial Monitor sẽ nói vậy một lần.

  • Một tệp thư viện không tìm thấy trong thư viện bạn đã thêm, chẳng hạn 'OneWire_direct_regtype.h'. Dự án mang theo bản sao của một thư viện mà Mokxi đã có sẵn, và bản sao đó được dùng. Hãy xóa nó bằng dấu x trên chip của nó trong dải Thư viện dưới phần code.

  • enumeration values 'WStype_PING' and 'WStype_PONG' not handled in switch. Đây là cảnh báo, không phải lỗi: các ví dụ của thư viện WebSockets bỏ sót một số kiểu sự kiện trong switch, và sketch vẫn chạy bình thường. Thêm default: break; để tắt cảnh báo. Xem WiFi, simulated về những gì client WebSockets có thể truy cập ở đây.

Giới hạn của bo mạch

  • global variables do not fit in the 2 KB SRAM. Mảng quá lớn hoặc chuỗi quá dài. Thu nhỏ lại, giữ chữ trong flash bằng F("..."), hoặc chọn bo có nhiều bộ nhớ hơn, chẳng hạn Mega 2560 hoặc ESP32.
  • firmware does not fit in the 32 KB flash. Chương trình lớn hơn khả năng của bo mạch. Bỏ những gì sketch không cần, hoặc chọn bo lớn hơn.
  • use of undeclared identifier 'Wire1'. Bo này chỉ có một bus I2C ở đây: dùng Wire và cho mỗi thiết bị một địa chỉ riêng.
  • use of undeclared identifier 'dacWrite'. Chỉ ESP32 cổ điển có DAC. Dùng analogWrite, hoặc chọn ESP32 DevKit.

Vẫn chưa giải quyết được

Nhấn Tại sao không biên dịch được? trong Mokxi AI, hoặc viết cho chúng tôi từ /support kèm lỗi và liên kết đến dự án. Xem thêm: