Arduinoのexit status 1エラー：コンパイルエラーの直し方

Arduinoのexit status 1エラーは、コードをコンパイルできなかった、つまりコンパイラーがプログラムをプロセッサーが理解できる機械語に変換できなかったことを知らせる一般的なメッセージで、本当の原因はこの行には書かれていません。原因は、出力パネルでその数行上にある、error:という語を含む最初の行にあります。名前を打ち間違えた、セミコロンを忘れた、ライブラリがインストールされていない、あるいはコードが別のボード向けに書かれていた、などです。Arduino IDE 2の右下に出るCompilation error: exit status 1の通知も、旧1.8版のError compiling for board Arduino Uno.という行も、まったく同じ意味です。

このガイドでは、まずコンパイルが裏側でどう動くか、エラーメッセージをファイル、行、列に分けてどう読むかを見ます。次に、最もよくあるコンパイルエラーを1つずつ見ていきます。was not declared in this scopeをはじめ、expected ';' before、No such file or directory、does not name a type、redefinition of、Sketch too bigです。それぞれについて、原因となる状況、コンパイラーが実際に出すメッセージ、そしてエラーなくコンパイルできる修正例を紹介します。さらに、間違ったボードを選んだことによるエラー、ESP32とRaspberry Pi Pico特有の問題、そして最後にすべてをまとめたエラーと解決法の表も加えました。コードは問題なくコンパイルできるのにボードに書き込めない場合は、問題は別の段階にあります。その場合はArduinoに書き込めないのガイドを参照してください。

Arduinoのexit status 1とは？コンパイルと書き込みの違い

「検証」（チェックマーク）や「書き込み」を押すと、Arduino IDEは裏でいくつかのプログラムを実行します。まずスケッチのフォルダにある.inoファイルをまとめ、先頭にArduino.hのヘッダーと関数のプロトタイプを加えて、普通のC++ファイルにします。次に、Unoならavr-g++、ESP32ならxtensa-esp32-elf-g++のようなコンパイラーがそのファイルと使っているライブラリをコンパイルし、リンカーがすべての部品を1つのプログラムにつなぎ、最後にIDEがプログラムがボードに収まるかを確認します。どのプログラムも終わるときに終了コードを返します。0は成功、1は失敗です。「exit status 1」はまさにそれを伝えていて、連鎖の中のプログラムのどれかが失敗したということです。そのため、書き込み中にavrdudeが失敗したときにも同じ言葉が出ます。どちらなのかは、その前にあるメッセージでわかります。

Arduinoのエラーメッセージの読み方

コンパイラーのエラー行はどれも同じ形をしています。まずファイル名、次にコロンで区切った行と列の番号、続いてエラーの種類と説明です。そのすぐ上には、どの関数の中のエラーかを示すIn function 'void loop()':のような行があることが多く、下には問題の行のコピーと、問題の場所を指す小さな^の印があります。errorはコンパイルを止める本当のエラー、warningは警告だけでコードはコンパイルされ、noteは前のメッセージに情報を補足します。コンパイラーは提案を加えることもよくあります。下の例ではsuggested alternative: 'digitalWrite'で正しいつづりを自ら示しています。

1. 「ファイル」>「基本設定」で、「より詳細な情報を表示する」の横にある「コンパイル」にチェックを入れます。こうすると、コンパイラーがどのファイルとどのライブラリのフォルダを使ったかも見えます。
2. ボードはつないでいなくても構いません。「検証」ボタン（チェックマーク）を押します。検証はコンパイルだけを行うので、エラーがコンパイルの段階にあるなら、「書き込み」を押しても時間の無駄です。
3. 出力パネルを一番上までスクロールし、error:を含む最初の行を探します。そのあとのエラーのほとんどは、最初のエラーの連鎖的な影響です。
4. メッセージの行番号に移動します。IDE 2ではエラーのある文字に赤い下線が引かれ、1.8版では行全体が赤くなります。その行に問題が見つからなければ、1つ上の行を見てください。
5. その最初のエラーだけを直し、もう一度「検証」を押します。エラーの数が急に減れば、正しい方向に進んでいます。
6. ネットで検索するときは、メッセージから自分の変数名やファイルのパスを取り除きます。'counter' was not declared in this scopeではなくwas not declared in this scopeで検索すると、ずっと多くの結果が出ます。一方、フォーラムで助けを求めるときは、出力全体をコピーしてください。

「was not declared in this scope」エラーとその直し方

このメッセージは、その場所で使った名前をコンパイラーが知らないことを意味します。最もよくある原因は打ち間違いです。Arduinoは大文字と小文字を区別するので、digitalwrite、Digitalwrite、digitalWriteは3つの別の名前です。2つ目の大きな原因はスコープです。変数をsetup()の中で宣言すると、それはsetup()が動いている間だけ存在し、loop()からは見えません。変数を複数の関数で使うなら、ファイルの先頭で、すべての関数の外に宣言してください。使う行より後で変数を宣言しても同じエラーになります。コンパイラーはファイルを上から下へ読むからです。最後に、ライブラリをインクルードしていないオブジェクト（Wire、Servo）や、選んだボードにない機能（UnoのSerial1）を使ったときにも、このエラーが出ます。

1// Kapsam (scope) örneği / Scope example
2const int LED_PIN = 13;   // global: her fonksiyon görür / global: every function can see it
3int yanmaSayisi = 0;      // setup() içine taşırsan loop() göremez / move it into setup() and loop() can't see it
4
5void setup() {
6  pinMode(LED_PIN, OUTPUT);
7  Serial.begin(9600);
8}
9
10void loop() {
11  int sure = 500;                // yerel: yalnız loop() içinde / local: only inside loop()
12  digitalWrite(LED_PIN, HIGH);   // digitalwrite yazarsan: was not declared / typing digitalwrite: was not declared
13  delay(sure);
14  digitalWrite(LED_PIN, LOW);
15  delay(sure);
16  yanmaSayisi++;
17  Serial.println(yanmaSayisi);   // kaç kez yandı / how many times it blinked
18}

「expected ';' before」とそのほかの構文エラー

C++では、どの文もセミコロンで終わります。行末のセミコロンを忘れると、コンパイラーは次の語を読んだときに初めて気づきます。そのため、Unoのコンパイラーではexpected ';' before 'delay'の行番号が間違いの1つ下の行を指します。足りないセミコロンは、delayの前の行の末尾にあります。ESP32やPicoのコアの新しいコンパイラーは、セミコロンがない行の末尾を直接指します。関数の最後の行で忘れると、メッセージはexpected ';' before '}' tokenになります。かっこのエラーも同じように振る舞います。ifブロックや関数の波かっこを閉じ忘れると、コンパイラーはファイルの最後まで読み進め、そこで初めてexpected '}' at end of inputと言います。閉じていない波かっこがsetup()の中にあると、a function-definition is not allowed here before '{' tokenも出ます。コンパイラーから見ると、loop()はsetup()の中で定義しようとしている関数になってしまうからです。forループのかっこの中でセミコロンの代わりにカンマを使うのも、この仲間の定番です。

「No such file or directory」：ライブラリが見つからない

fatal error: DHT.h: No such file or directoryという行と、それに続くcompilation terminated.は、コードの#includeの行で指定したファイルがパソコンで見つからなかったことを示しています。「fatal」は、その時点でコンパイルが完全に止まったという意味なので、これを直すまでコードの残りの部分のエラーは表示されません。原因はほぼ必ず、インストールされていないライブラリです。ネットで見つけたプロジェクトを開いたら、先頭の#includeの行を1つずつ読み、それぞれのライブラリを「ツール」>「ライブラリを管理」からインストールします。依存ライブラリについて聞くウィンドウで「全てをインストール」を選ばないと、メインのライブラリはインストールされても、それが必要とする2つ目のライブラリが足りないままになります。その場合、メッセージのファイル名は自分が書いたものではなく、ライブラリの中から呼ばれたファイル（たとえばAdafruit_Sensor.h）になります。ファイル名の大文字と小文字も重要です。Linuxではdht.hとDHT.hは別のファイルです。ライブラリのインストールの3つの方法とZIPの問題は、Arduinoにライブラリを追加する方法のガイドを参照してください。

「does not name a type」エラー

does not name a typeは、コンパイラーが行の先頭にデータ型（int、float、Servo、LiquidCrystal_I2Cなど）を期待したのに、書かれた語を認識できなかったことを意味します。よくある原因は3つです。1つ目はライブラリの#includeの行を忘れることです。Servo.hなしでServo lid;をコンパイルすると'Servo' does not name a typeになります。2つ目は型のつづりの誤りです。正しいのはstringではなくString、Intではなくintで、コンパイラーはdid you mean 'String'?で助けてくれることがよくあります。3つ目で最も意外なのは、関数の外にコマンドを書くことです。関数の外では宣言しかできません。int angle = 0;は有効ですが、そのあとの行にangle = 90;を単独で書くと、コンパイラーはangleを型名と受け取り、'angle' does not name a typeと報告します。Arduino特有の落とし穴がもう1つあります。IDEは関数のプロトタイプを最初の関数の直前に自動で追加します。自分のstruct型を返す関数を書き、そのstructをsetup()より下で宣言していると、プロトタイプがstructより前に来てしまい、同じエラーになります。直すには、structの定義をファイルの先頭、最初の関数より前に移してください。

1#include <Servo.h>   // bu satır yoksa: 'Servo' does not name a type / without it: 'Servo' does not name a type
2
3struct Olcum {       // struct'ı ilk fonksiyondan önce tanımla / define structs before the first function
4  int ham;
5  float volt;
6};
7
8Servo kapak;         // tür adı büyük harfle başlar / the type name starts with a capital letter
9int aci = 0;         // dışarıda tanım ve ilk değer serbest / declaring with a value outside is fine
10// aci = 90;         // dışarıda tek başına atama: 'aci' does not name a type / bare assignment outside: error
11
12Olcum potOku() {
13  Olcum o;
14  o.ham = analogRead(A0);           // potansiyometre A0'da / potentiometer on A0
15  o.volt = o.ham * 5.0 / 1023.0;    // 0-1023 değerini volta çevir / convert 0-1023 to volts
16  return o;
17}
18
19void setup() {
20  Serial.begin(9600);
21  kapak.attach(9);   // servo sinyali D9 / servo signal on D9
22}
23
24void loop() {
25  Olcum o = potOku();
26  aci = map(o.ham, 0, 1023, 0, 180);   // atama fonksiyonun içinde / assignment inside a function
27  kapak.write(aci);
28  Serial.println(o.volt);
29  delay(20);
30}

「redefinition of」エラー：同じものを2回定義している

redefinition of 'void setup()'エラーは、同じ名前の定義が2つあることを示しています。そのすぐ下のnote: 'void setup()' previously defined hereの行が、1つ目がどこにあるかを示します。初心者に最もよくある原因は、2つのスケッチ例を1つのファイルに続けて貼り付けることです。setup()とloop()が2つずつできてしまいます。2つ目の原因はタブです。Arduino IDEはコンパイルの前に、スケッチのフォルダにあるすべての.inoファイルを1つにまとめます。フォルダにコピーした古いバックアップ（たとえばproject_old.ino）や、独自のsetup()とloop()を持つ2つ目のタブがあると、そのタブを一度も開いていなくてもこのエラーになります。直すには、そのファイルをフォルダの外に移してください。同じ変数を2回宣言しても似たメッセージredefinition of 'int led'が出ます。このエラーのリンカー版はmultiple definition ofで、ヘッダー（.h）ファイルで値を与えた変数を2つの別々の.cppファイルでインクルードしたときに出ます。その反対のundefined reference toは、プロトタイプは書いたのに中身を書いていない関数、または名前を違うつづりで書いた関数を指しています。

1// İki örneği birleştirmek: tek setup(), tek loop() / Merging two sketches: one setup(), one loop()
2const int LED_PIN = 13;          // 1. örnek: Blink / sketch 1: Blink
3const int POT_PIN = A0;          // 2. örnek: potansiyometre / sketch 2: potentiometer
4unsigned long oncekiZaman = 0;   // millis() zamanlayıcısı / millis() timer
5bool ledDurum = false;
6
7void setup() {
8  pinMode(LED_PIN, OUTPUT);      // 1. örneğin setup içeriği / setup body of sketch 1
9  Serial.begin(9600);            // 2. örneğin setup içeriği / setup body of sketch 2
10}
11
12void loop() {
13  // 1. örnek: delay yerine millis ile yanıp sönme / sketch 1: blink with millis instead of delay
14  if (millis() - oncekiZaman >= 500) {
15    oncekiZaman = millis();
16    ledDurum = !ledDurum;
17    digitalWrite(LED_PIN, ledDurum);
18  }
19  // 2. örnek: potansiyometreyi oku ve yaz / sketch 2: read and print the potentiometer
20  int deger = analogRead(POT_PIN);   // 0-1023 arası / between 0 and 1023
21  Serial.println(deger);
22  delay(50);
23}

まとめるときは次の順番で進めます。まず両方のスケッチの#includeの行を重複なく先頭に集め、次にグローバル変数と定数を加えます。同じ名前が両方にあれば、片方の名前を変えます。次に、両方のsetup()の中身を1つのsetup()に、両方のloop()の中身を1つのloop()に入れます。片方のスケッチが長いdelay()を使っていると、もう片方の邪魔をします。これはdelay()の代わりにmillis()を使う時間管理の手法で解決できます。最後に、2つのスケッチが同じピンを使っていないか確認してください。コンパイラーは気づきませんが、回路は思ったとおりに動きません。

「Sketch too big」とメモリ不足のエラー

コンパイルが成功すると、最後に2つの行が表示されます。上のスコープの例をUno向けにコンパイルすると、Sketch uses 2212 bytes (6%) of program storage space. Maximum is 32256 bytes.（プログラムの使用量と最大値）という行がプログラムがどれだけのフラッシュメモリを使うかを、Global variables use 190 bytes (9%) of dynamic memoryという行がグローバル変数がRAMをどれだけ使うかを示します。プログラムがフラッシュに収まらないと100パーセントを超え、続いてSketch too bigの警告とtext section exceeds available space in boardのエラーが出ます。グローバル変数がRAMに収まらない場合は、代わりにNot enough memoryとdata section exceeds available space in boardが出ます。RAMの使用量が75パーセントを超えると、IDEはLow memory available, stability problems may occur（メモリが少なく、不安定になる可能性がある）という警告を出すことがあります。コードはコンパイルされますが、実行中にローカル変数の置き場所がなくなるため、ボードがランダムに固まったり勝手に再起動したりすることがあります。Unoでは32 KBのフラッシュのうち0.5 KBをブートローダーが使うので、上限は32256バイトです。

1// RAM tasarrufu: F() ve PROGMEM / Saving RAM: F() and PROGMEM
2const char mesaj[] PROGMEM = "Bu uzun metin RAM yerine flasta durur";   // flaşta saklanır / stored in flash
3const byte notalar[] PROGMEM = {60, 62, 64, 65, 67, 69, 71, 72};      // byte: int'in yarısı / byte: half of an int
4
5void setup() {
6  Serial.begin(9600);
7  Serial.println(F("Merhaba! Bu metin de flastan okunur"));   // F(): RAM harcamaz / F(): uses no RAM
8  char tampon[48];                                            // geçici RAM tamponu / temporary RAM buffer
9  strcpy_P(tampon, mesaj);                                    // flaştan RAM'e kopyala / copy from flash to RAM
10  Serial.println(tampon);
11  for (byte i = 0; i < sizeof(notalar); i++) {
12    Serial.print(pgm_read_byte(&notalar[i]));                 // flaştan bir bayt oku / read one byte from flash
13    Serial.print(' ');
14  }
15  Serial.println();
16}
17
18void loop() {
19}

• 固定の文字列をF()で囲む：Serial.println(F("System ready"));は、文字列をRAMにコピーせずフラッシュから直接読みます。LCDやOLEDのディスプレイに表示する固定の文字列も同じです。
• 大きな配列をPROGMEMに移す：音符の表、ディスプレイのビットマップ、長い文章が変わらないなら、RAMに置く必要はありません。より詳しい手法はArduinoのメモリ不足の記事を参照してください。
• 正しいデータ型を選ぶ：0〜255の値にはbyte（1バイト）で十分です。Unoではintは2バイト、longとfloatは4バイトを使います。
• Stringクラスを減らす：何度も連結されるStringオブジェクトはRAMを断片化させます。固定長のchar配列のほうが予測しやすくなります。
• ディスプレイのライブラリの隠れた必要量を知る：Adafruit SSD1306は、128×64のOLEDディスプレイ用に、実行時に1 KBのバッファを確保します。このメモリはコンパイルの報告には現れないので、報告が70パーセントでもディスプレイが起動しないことがあります。
• 大きなボードに移る：Unoに詰め込めないプロジェクトも、MegaやESP32なら余裕で動きます。ESP32では、「ツール」>「Partition Scheme」でHuge APP (3MB No OTA/1MB SPIFFS)を選ぶと、プログラムの領域を1.25 MBから3 MBに増やせます。この選択肢では無線でのアップデート（OTA）は使えません。

間違ったボードを選んだことによるエラー

コンパイラーは、常に「ツール」>「ボード」（IDE 2では上部のボード選択欄）で選んだボードのプロセッサー向けにコードをコンパイルします。同じコードでも、Megaならきれいにコンパイルできて、Unoを選ぶと失敗することがあります。ボードごとにハードウェア、ピンの名前、ボードパッケージに付属するライブラリが違うからです。ネットで見つけたプロジェクトを開いたら、まずどのボード向けに書かれたかを確認してください。ESP32向けのコードはUnoを選ぶとコンパイルできず、プロセッサーのレジスタに直接アクセスするUno向けのコードはESP32を選ぶとコンパイルできません。一覧に自分のボードがまったく見当たらない場合は、ボードパッケージがインストールされていません。ESP32とRaspberry Pi Picoのパッケージはボードマネージャからインストールする必要があります。手順はArduino IDEのインストール方法のガイドを参照してください。

ESP32でのコンパイルエラー

ESP32もArduinoの言語でプログラムしますが、コンパイラーとボードパッケージが違うので、Unoではきれいにコンパイルできるコードが、ESP32ではつまずくことがあります。最もよくある理由はコアのバージョンです。ESP32 Arduinoコアのバージョン3.xではPWMの関数が変わり、ledcSetup()とledcAttachPin()が削除されて、チャンネル番号ではなくピン番号で動くledcAttach()とledcWrite()に置き換えられました。そのため、ネットの古い例では'ledcSetup' was not declared in this scopeが出ます。コードを新しい関数に書き換えるか、ボードマネージャからバージョン2.0.17をインストールしてください。2つ目の違いはコンパイラーの設定です。Unoのコアはコードを-fpermissiveオプションでコンパイルし、一部のエラーを警告にとどめます。ESP32はこれを使いません。たとえば、switchの中で波かっこなしに変数を宣言すると、Unoではコンパイルできますが、ESP32ではjump to case labelエラーになります。最近のESP32のコアは-Werror=return-typeでもコンパイルします。値を返すべき関数でreturnを忘れると、「コンパイラの警告」（Compiler warnings）を「なし」（None）以外にしている限り、no return statement in function returning non-voidになります。バージョン2.xでは、「コンパイラの警告」を「もっと」（More）や「全て」（All）にすると、ほとんどの警告がエラーになります。ボードの基本的な準備についてはESP32とは？の記事を見てください。

1// ESP32 Arduino paketi 3.x / ESP32 Arduino core 3.x
2const int LED_PIN = 2;        // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3const int FREKANS = 5000;     // PWM frekansı 5 kHz / PWM frequency 5 kHz
4const int COZUNURLUK = 8;     // 8 bit: 0-255 arası / 8 bits: range 0-255
5
6int parlaklik(int adim) {
7  return (adim % 32) * 8;     // return unutulursa 3.x'te derleme hatası olabilir / a missing return can fail to compile on 3.x
8}
9
10void setup() {
11  Serial.begin(115200);
12  // eski 2.x kodu / old 2.x code: ledcSetup(0, FREKANS, COZUNURLUK); ledcAttachPin(LED_PIN, 0);
13  ledcAttach(LED_PIN, FREKANS, COZUNURLUK);   // 3.x: kanal otomatik seçilir / channel is picked automatically
14}
15
16void loop() {
17  for (int adim = 0; adim < 32; adim++) {
18    ledcWrite(LED_PIN, parlaklik(adim));      // 3.x: pin numarasıyla yaz / write using the pin number
19    delay(30);
20  }
21  if (Serial.available()) {
22    switch (Serial.read()) {
23      case 'h': {                             // case içinde değişken varsa süslü parantez şart / braces needed if a case declares a variable
24        int deger = ledcRead(LED_PIN);
25        Serial.println(deger);
26        break;
27      }
28      default:
29        break;
30    }
31  }
32}

Raspberry Pi Pico：Arduino IDEとMicroPythonのエラー

PicoをArduino IDEで、つまりEarle Philhower氏のarduino-picoコアでプログラムする場合、コンパイラーはやはりGCCで、この記事のメッセージはすべてそのまま当てはまります。MicroPythonは違います。事前の独立したコンパイルの段階はなく、Picoは起動時にファイルをバイトコードに変え、1行ずつ実行します。そのため、エラーはThonnyの下部のShellペインに、Traceback (most recent call last):で始まるメッセージとして表示されます。このメッセージは下から上へ読んでください。最後の行がエラーの種類と説明を、その上のline 7の部分がどの行かを示します。構文エラー（SyntaxError、IndentationError）はプログラムが始まる前に報告されますが、ほかのエラーはプログラムがその行に達したときに初めて現れるので、コードがしばらく問題なく動いてから止まることもあります。MicroPythonのインストールと最初の手順はRaspberry Pi Picoとは？の記事を参照してください。

1from machine import Pin
2import time
3
4led = Pin("LED", Pin.OUT)     # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
5sayac = 0
6
7while True:                   # iki nokta unutulursa SyntaxError / a missing colon gives SyntaxError
8    led.toggle()              # blok içinde 4 boşluk girinti / 4-space indent inside the block
9    sayac += 1
10    print("Sayac:", sayac)    # "Sayac: " + sayac yazmak TypeError verir / "Sayac: " + sayac raises TypeError
11    time.sleep(0.5)

Arduinoのコンパイルエラーと解決法の表

エラーのないコードを書くための次のステップ

• 基本を固める：Arduinoプログラミングの基本の記事で、変数、スコープ、関数、ループを解説しています。この記事のエラーのほとんどは、これらのテーマから生じます。
• コマンドの正しい書き方を覚える：Arduinoのコマンド一覧では、すべてのコマンドの構文と引数を例付きで示しています。
• ライブラリを正しくインストールする：Arduinoにライブラリを追加する方法のガイドで、No such file or directoryとMultiple libraries were foundのメッセージを詳しく扱っています。
• 実行中のコードの動きを見る：コンパイルはできるのに思ったとおりに動かないコードでは、シリアルモニタで変数を表示するのが最も早い診断方法です。
• ボードなしで試す：WokwiやTinkercadのシミュレーターでは、コードをコンパイルして回路と一緒に動かせます。
• AIが書いたコードを確認する：チャットボットが作るコードは、古いライブラリの版や別のボード向けに書かれていることがよくあります。AIでArduinoのコードを書くの記事で、こうした問題の見つけ方を説明しています。

コンパイルエラーは最初は怖く見えるかもしれませんが、コンパイラーは実際には問題の場所と、多くの場合その直し方まで教えてくれます。ファイル、行、列、そして短い説明です。最初のエラーを読み、それだけを直し、再コンパイルするというループを繰り返しましょう。いくつかのプロジェクトをこなすうちに、数秒でエラーを解決できるようになります。コードがコンパイルされて書き込めたら、BlueGraysアプリのLED、ボタン、センサー、ディスプレイのプロジェクトに進めます。Arduino、ESP32、Raspberry Pi Picoのどのプロジェクトにも、回路図ときれいにコンパイルできるコードがステップごとに付いています。