エラーが起きたら最初にすること

Arduino IDEでコードを検証（Verify）または書き込む（Upload）と、出力欄に赤い文字でエラーが表示されることがあります。1行だけのこともあれば、画面いっぱいに大量の文字が流れることもありますが、慌てる必要はありません。

この記事では、検索で見つかりやすい代表的なエラー文をそのまま見出しにしています。今表示されているエラーに近いものを、目次または下記のCtrl+F（Macは⌘+F）で探して読み進めてください。エラーの読み方の全体像は、Arduino公式サポートの「If your sketch doesn’t compile」↗にもまとまっています。

構文エラー編（書き間違いで起きるもの）

ここで紹介する6つは、いずれもコードの書き方そのものが原因で起きるコンパイルエラーです。ボードや配線とは関係なく、コードの中だけで解決できます。

expected ‘;’ before …

コンパイルエラー

最も頻繁に見かけるエラーの1つです。「ここまでの文の終わりに、セミコロン（;）があるはずなのに見当たりません」という意味です。実際にエラーが指す行ではなく、その1行前にセミコロンの書き忘れがあるケースがほとんどです。

void loop() {
  int ledPin = 8
  digitalWrite(ledPin, HIGH);  // ← ここがエラー行として指摘される
}

FIX ↓

void loop() {
  int ledPin = 8;               // 行末にセミコロンを追加
  digitalWrite(ledPin, HIGH);
}

expected ‘}’ at end of input

コンパイルエラー

波かっこ{ }の数が合っていない時に出るエラーです。「ファイルの最後まで来たのに、閉じるはずの } が見つかりません」という意味で、どこかで{だけ書いて}を書き忘れています。

void loop() {
  if (digitalRead(2) == LOW) {
    digitalWrite(8, HIGH);
  // ← if文を閉じる } が1つ足りない
  digitalWrite(8, LOW);
}

FIX ↓

void loop() {
  if (digitalRead(2) == LOW) {
    digitalWrite(8, HIGH);
  }                              // if文を閉じる } を追加
  digitalWrite(8, LOW);
}

‘xxx’ was not declared in this scope

コンパイルエラー

「xxxという名前は、このあたりでは宣言されていません」という意味です。変数名やライブラリのクラス名のスペルミス、変数を使う前に宣言し忘れている、必要な#includeを書き忘れている、といったケースで発生します。

const int ledPin = 8;
void setup() {
  pinMode(ledPin, OUTPUT);
}
void loop() {
  digitalWrite(ledPn, HIGH);  // ← ledPin のスペルミス（nが抜けている）
}

FIX ↓

digitalWrite(ledPin, HIGH);   // 正しいスペルに修正

redefinition of ‘xxx’

コンパイルエラー

同じ名前の変数や関数を、同じ場所で2回定義してしまった時に出るエラーです。コードをコピペで組み合わせた時に発生しやすく、「さっき定義したxxxを、もう一度定義しようとしています」という意味です。

void blinkLed() {
  digitalWrite(8, HIGH);
  delay(200);
  digitalWrite(8, LOW);
}
// ...途中のコードを省略...
void blinkLed() {              // ← 同じ名前の関数がもう1つある
  digitalWrite(9, HIGH);
  delay(200);
  digitalWrite(9, LOW);
}

FIX ↓

void blinkLed8() { /* ... */ }   // 名前を分ける
void blinkLed9() { /* ... */ }

two or more data types in declaration of ‘xxx’

コンパイルエラー

これも実はセミコロン抜けが原因になる、少し変わった見え方をするエラーです。「1つの宣言の中に、型（int・Servoなど）が2つ以上混ざっています」という意味ですが、実際には前の行のセミコロンが抜けていて、2行が1つの文として合体してしまっているだけのことがほとんどです。

int ledPin = 8
int buttonPin = 2;   // ← 前の行にセミコロンがないため
                      //   「int ... int」が1つの宣言として読まれてしまう

FIX ↓

int ledPin = 8;       // セミコロンを追加
int buttonPin = 2;

stray ‘\xxx’ in program（コピペ起因の文字化け）

コンパイルエラー

特に日本語環境でとても多い原因不明エラーです。「プログラムの中に、見慣れない文字（迷い込んだ文字）があります」という意味で、多くはブログやWord文書からコードをコピペした時に、半角のクォーテーション（” や ‘）が全角・スマート引用符（“ ” や ‘ ’）に自動変換されてしまっていることが原因です。見た目はほとんど同じなので、目視では気づきにくいのが厄介な点です。

void loop() {
  Serial.println("Hello");  // ← 見た目は普通の引用符に見えるが
}                            //   実際は全角のスマート引用符になっている場合がある

FIX ↓

void loop() {
  Serial.println("Hello");  // 半角のダブルクォートに打ち直す
}

型・関数の使い方編

コード自体は概ね正しくても、値の種類（型）やライブラリの関数名の扱い方で起きるエラーです。

invalid conversion from ‘const char*’ to ‘char’

コンパイルエラー

ダブルクォート（”）とシングルクォート（’）を取り違えた時に出るエラーです。ダブルクォートで囲むと「文字列（複数文字の並び）」、シングルクォートで囲むと「1文字だけの文字（char型）」という、まったく別のデータになります。

char grade = "A";  // ← ダブルクォートは「文字列」を作ってしまう

FIX ↓

char grade = 'A';  // 1文字だけならシングルクォート

char型と文字列（クォートの使い分け）の正式な仕様は、Arduino公式のchar言語リファレンス ↗で確認できます。

‘class xxx’ has no member named ‘yyy’

コンパイルエラー

使っているライブラリのクラス（Servoなど）に、指定した名前の関数が存在しない時に出るエラーです。関数名のスペルミス、または参考にしたコードと実際にインストールしたライブラリのバージョンが違う、というケースが典型的です。

Servo myServo;
void setup() {
  myServo.attache(9);  // ← attach のスペルミス
}

FIX ↓

myServo.attach(9);

ライブラリ・ファイル関連編

ここからは、コードそのものよりも「必要なファイルやライブラリが揃っているか」に関わるエラーです。

No such file or directory

コンパイルエラー

#includeで指定したファイル（多くはライブラリのヘッダファイル）が見つからない時に出るエラーです。原因はおおむね2つ、「ライブラリがインストールされていない」か「ファイル名のスペルミス・大文字小文字の違い」です。

#include <Servo.h>   // Servoライブラリが未インストールだとここでエラー
Servo myServo;
void setup() {
  myServo.attach(9);
}

Multiple libraries were found for “xxx.h”

警告（多くはエラーではない）

同じ名前のライブラリが複数の場所にインストールされている時に表示されるメッセージです。実はこれ自体はエラーではなく、情報として表示されているだけのことが多いです。「Used:」の行に書かれているライブラリが実際に使われるので、それが正しければ問題ありません。

ボード・容量設定編

コード自体に問題がなくても、Arduino IDE側の設定や、ボードの容量オーバーが原因でエラー・警告になることがあります。

Missing FQBN (Fully Qualified Board Name)

コンパイルエラー

FQBN（Fully Qualified Board Name）とは、「どの会社の、どのシリーズの、どのボード向けにコンパイルするか」を表す識別子です。このエラーは、ボードが1つも選択されていない時に出ます。ボードを接続していなくても、検証（Verify）だけであってもボードの選択自体は必要です。

Low memory available, stability problems may occur

警告（エラーではない）

これはエラーではなく警告です。コードは正常に書き込めますが、変数を保存しておくメモリ（SRAM／動的メモリ）の残りが少ないという知らせです。SRAMがほぼ埋まると、動作中に予期しないリセットや値化けなど、不安定な動きにつながることがあります。

より詳しい削減方法は、公式の「Reduce the size and memory usage of your sketch」↗にまとまっています。

does not fit in available space（容量オーバー）

コンパイルエラー

今度はフラッシュメモリ（コード本体を保存する容量）が足りない時に出る、正真正銘のエラーです。コードやライブラリが大きすぎて、選んでいるボードの容量に収まらないという意味です。

こちらも同じ公式の「Reduce the size and memory usage of your sketch」↗で、削減のテクニックが詳しく紹介されています。

exit status 1 / Error compiling for board …

コンパイルエラー（総称メッセージ）

これは具体的な原因を示すメッセージではなく、「とにかくコンパイルに失敗しました」という総称のラッパーメッセージです。この1行だけを見ても原因は分かりません。この行より上に表示されている、具体的なエラー（今回紹介したような内容）を探すのが正しい読み方です。

書き込み（アップロード）トラブル編

コンパイルが成功しても、実際にボードへ転送する「書き込み（アップロード）」の段階で止まることがあります。この段階のエラーにはavrdudeという文字がよく登場します。これはArduinoへの書き込みを担当する内部プログラムの名前です。

avrdude: ser_open(): can’t open device …

書き込みエラー

指定されたポート（COMポートや/dev/…）を開けなかった、という意味です。多くの場合、選んでいるポートに実際にはボードがつながっていないことが原因です。

詳しい原因の切り分けは、公式の「’Error: avrdude’ when uploading」↗にまとまっています。CH340チップ搭載の互換ボードでcan't set com-stateという表示が出る場合は、ドライバ関連の専用ページ ↗も参考にしてください。

avrdude: stk500_getsync(): not in sync

書き込みエラー

ボードとの通信は始まったものの、想定していた合図（同期信号）が返ってこなかった、という意味です。ポート自体は開けているのに書き込みが失敗する時に出ます。

より詳しいケースごとの対処は、上記と同じ公式の「’Error: avrdude’ when uploading」↗で確認できます。

avrdude: verification error; content mismatch

書き込みエラー

書き込み自体は完了したものの、書き込んだ後に内容を確認（ベリファイ）したところ、実際にボードに書き込まれた内容と送ったはずの内容が一致しなかった、という意味です。通信が途中でノイズなどにより乱れたことが多いです。

こちらも公式の「’Error: avrdude’ when uploading」↗にavrdude関連のトラブルとしてまとめて掲載されています。

ポートが表示されない

書き込みエラー（設定）

ツール＞ポートのメニューを開いても、そもそも一覧に何も表示されない、あるいはボードが見つからない状態です。エラーメッセージというより、書き込み以前の設定段階での代表的なつまずきです。

症状別のチェック項目は、公式の「If your board does not appear in the port menu」↗にさらに詳しくまとまっています。ブレッドボードや配線そのものを見直したい場合はブレッドボード完全攻略ガイド ↗もあわせてご覧ください。

書き込み中に止まる（進捗バーが動かなくなる）

書き込みエラー

「アップロード中…」の表示や進捗バーのまま、何のエラーも出ずに止まってしまう症状です。エラーメッセージが出ないため原因が分かりにくく感じますが、確認する項目自体は他の書き込みトラブルとほぼ共通です。

アップロード全般のトラブルは、公式の「If your sketch doesn’t upload」↗に、症状別のチェックリストとしてまとめられています。

実行時トラブル編

コンパイルも書き込みも成功しているのに、期待通りの結果にならない2つのケースです。Arduino IDEはエラーとして教えてくれないため、自分で切り分ける必要があります。

シリアルモニタが文字化けする

実行時トラブル

シリアルモニタを開くと、意味のわからない記号や文字がずらずらと表示される症状です。ほぼ確実にボーレート（通信速度）の不一致が原因です。コード内のSerial.begin(9600)の数字と、シリアルモニタ画面右下（または右上）のボーレート選択の数字が一致していないと発生します。

void setup() {
  Serial.begin(9600);   // コード側は9600bpsで設定
}
void loop() {
  Serial.println("Hello");
  delay(1000);
}
// → シリアルモニタ側が115200になっていると文字化けする

コードは書き込めたが動かない

実行時トラブル

コンパイルも書き込みも成功したのに、LEDが光らない、ボタンが反応しない、という状態です。原因はコードの外側、つまり配線と、コードの中のロジック（条件や計算の間違い）のどちらかにあります。

エラー調査の共通ルール