undefined reference to の原因と直し方|コンパイルは通るのにリンクで落ちる【C言語】

 C言語 

 gcc 

 エラー 

作成日:2026/11/17

💡
結論:原因と直し方 ・原因:関数の宣言はあるのに、本体(中身)がどこにも見つからない。コンパイルは通り、最後の「リンク」で落ちています。 ・直し方: undefined reference to  の後ろの名前を見て、①数学関数なら  -lm  を付ける ②別ファイルの関数なら、そのファイルも gcc に渡す ③名前のタイプミスを直す ④ main  なら  main  の書き間違いを直す。

どんなエラーか

 sqrt (平方根)を使ったプログラムを、いつもどおり  gcc u1.c  でコンパイルします。

#include <stdio.h>
#include <math.h>

int main(void) {
    double x;
    scanf("%lf", &x);
    printf("%f\n", sqrt(x));
    return 0;
}

gcc 13(Ubuntu)の実際の出力です。

/usr/bin/ld: /tmp/cciCC38y.o: in function `main':
u1.c:(.text+0x40): undefined reference to `sqrt'
collect2: error: ld returned 1 exit status

 #include <math.h>  は書いてあるのにエラーになります。ポイントは1行目の  /usr/bin/ld  と、最後の  ld returned 1 exit status  です。ld(リンカ)が出しているエラーで、ソースの文法の間違いではありません。

コンパイルとリンクは別の作業

 gcc u1.c  の1回のコマンドの中で、実は2つの作業が動いています。

u1.cソース
→
コンパイル文法チェック・機械語に
→
u1.osqrt は「どこかにある」
と書いた紙だけ
→
リンク(ld)sqrt の本体を探す
→
a.out
libcprintf・scanf の本体
(いつも自動で探す)
libmsqrt・pow・sin の本体
(-lm を付けないと探さない)

#include は「こういう関数がある」という宣言だけ。本体はライブラリの中にあり、リンクのときに探す。

コンパイル:1ファイルずつ文法を調べて、機械語(.o ファイル)にします。 #include <math.h>  で「 sqrt  という関数がある」と宣言されていれば、ここは通ります。

リンク:.o ファイルとライブラリを集めて、呼び出している関数の本体を探し、1つの実行ファイルにします。本体が見つからないと  undefined reference to  になります。

関数の「宣言」と「本体」の違いは、C言語入門の関数の話でも出てきます。

パターン1:数学関数で -lm を付け忘れた

 sqrt ・ pow ・ sin ・ log  などの本体は、数学ライブラリ(libm)に入っています。Linux の gcc では、libm は自動では探さないので  -lm  を付けます。

$ gcc u1.c -lm
$ echo 2 | ./a.out
1.414214

 -lm  はソースファイルより後ろに書きます。 gcc -lm u1.c  の順だと、環境によっては同じエラーのままです(リンカは前から順に読み、その時点で必要な関数だけを取り出すため)。

📌
Mac(clang)では libm も自動でリンクされるので、 -lm  なしで通ります。「Macでは動いたのに学校の Linux でエラー」はこのパターンが多いです。

パターン2:別ファイルの関数を渡し忘れた

 main  を u2main.c、 add  を u2add.c に分けて書いたのに、u2main.c だけをコンパイルした場合です。

// u2main.c
#include <stdio.h>

int add(int a, int b);

int main(void) {
    printf("%d\n", add(2, 3));
    return 0;
}
$ gcc u2main.c
/usr/bin/ld: /tmp/ccYKUfxL.o: in function `main':
u2main.c:(.text+0x13): undefined reference to `add'
collect2: error: ld returned 1 exit status

 add  の宣言(1行のプロトタイプ)はあるのでコンパイルは通りますが、本体は u2add.c の中です。両方を渡せば通ります。

$ gcc u2main.c u2add.c
$ ./a.out
5

VS Code の「実行ボタン」や Code Runner は、開いている1ファイルだけをコンパイルする設定のことが多いです。ファイルを分けたらターミナルで両方を渡すか、 tasks.json  の引数を  ${fileDirname}/*.c  のように変えます。

パターン3:関数名のタイプミス

 hello  を呼ぶつもりで  helo  と書いた場合です。

u3.c: In function 'main':
u3.c:6:5: warning: implicit declaration of function 'helo'; did you mean 'hello'? [-Wimplicit-function-declaration]
    6 |     helo();
      |     ^~~~
      |     hello
/usr/bin/ld: /tmp/cctY6iOq.o: in function `main':
u3.c:(.text+0xe): undefined reference to `helo'
collect2: error: ld returned 1 exit status

リンクのエラーの前に、 implicit declaration of function  の警告が出ています。警告を読むと  did you mean 'hello'?  と答えまで書いてあります。上に出ている警告から順に読むのが近道です。この警告については「implicit declaration of function」の記事でも書いています。

パターン4:undefined reference to `main'

 main  の綴りや大文字小文字を間違えると、こう出ます。

/usr/bin/ld: /usr/lib/gcc/x86_64-linux-gnu/13/../../../x86_64-linux-gnu/Scrt1.o: in function `_start':
(.text+0x1b): undefined reference to `main'
collect2: error: ld returned 1 exit status

プログラムは  main  から始まる決まりなので、 Main ・ mian ・ main  のないファイルだけをコンパイルした、のどれかです。

エラーの名前からの見分け方

undefined reference to の後ろよくある原因直し方
sqrt pow sin log数学ライブラリを付けていない最後に -lm
自分で作った関数本体を書いたファイルを渡していない/本体を書き忘れたgcc a.c b.c のように全部渡す
少し違う名前タイプミス(警告に did you mean が出る)名前をそろえる
mainmain の綴り・大文字int main(void) に直す
pthread_create などそのライブラリを付けていない-pthread など、マニュアルにある指定を付ける

Mac では「Undefined symbols」と出る

Mac の clang では、同じ原因でも文言が違います。

Undefined symbols for architecture arm64:
  "_add", referenced from:
      _main in u2main-xxxx.o
ld: symbol(s) not found for architecture arm64

名前の前に  _  が付いていますが、意味は同じで「 add  の本体が見つからない」です。

まとめ

 undefined reference to  は、コンパイルではなくリンクのエラー

宣言(#include やプロトタイプ)はあるが、本体が見つからない

数学関数は  -lm 、分けたファイルは全部渡す、名前のミスは上の警告を読む

ほかのエラーは、stray '\343' in program、makes pointer from integer without a cast、format '%d' expects argument of type でまとめています。

C言語でよく出るエラーはC言語 エラー一覧にまとめています。