リンカー

C言語におけるLNK2005エラーの原因と対策について解説

2025-02-19更新日: 2025-02-19

c言語でLNK2005エラーが発生する場合、同じシンボルが複数回定義されていることが原因です。

特にヘッダーファイルにグローバル変数や関数定義を書いた場合、複数のソースファイルから参照されることでエラーとなります。

宣言と定義を分ける、またはinlineやstatic修飾子を使って定義範囲を限定する対策により、問題の解消が期待できます。

目次から探す

エラーの原因詳細
- ヘッダーファイルでの定義重複
- オブジェクトファイル間での定義衝突
対策と解決方法
原因別具体例
- ヘッダーファイルの修正例
- ライブラリリンク設定の調整例
まとめ

エラーの原因詳細

ヘッダーファイルでの定義重複

ヘッダーファイル内にグローバル変数や関数の定義を直接記述すると、複数のソースファイルからインクルードされる際に同一シンボルが複数回定義され、LNK2005 エラーが発生する可能性があります。

以下は、グローバル変数をヘッダーファイル内で定義した場合の一例です。

グローバル変数の重複定義

例えば、ヘッダーファイルに以下のように記述すると、複数のソースファイルで同じ global_var が定義され、リンカは重複を検出してエラーを出す可能性があります。

#include <stdio.h>
// ヘッダーファイルにグローバル変数を定義
int global_var = 100;
int main(void) {
    printf("global_var = %d\n", global_var);
    return 0;
}

この場合、別のソースファイルでも同じヘッダーファイルをインクルードすると、オブジェクトファイル間で同じ変数定義が生じ、リンカエラーとなります。

非inline関数の定義による衝突

ヘッダーファイル内で、inline キーワードを付加せずに関数の実装を記述すると、各ソースファイルに同一の関数定義が展開され、複数定義エラーが発生する場合があります。

例えば、以下のような実装は、複数ソースファイルにより関数が重複して定義される原因となります。

#include <stdio.h>
// ヘッダーファイル内での非inline関数の定義例
int compute(int num) {
    return num * 2;
}
int main(void) {
    printf("compute(5) = %d\n", compute(5));
    return 0;
}

各ソースファイルにこの関数が展開されると、リンカはどの関数定義を使用すべきかを判断できず、LNK2005 エラーが発生します。

オブジェクトファイル間での定義衝突

複数のオブジェクトファイルやライブラリを組み合わせてリンクする場合、同一シンボルが異なるオブジェクトファイル内で定義されていると、衝突が発生してリンカエラーとなる可能性があります。

複数ライブラリの組み合わせによる影響

たとえば、標準ライブラリと自作ライブラリ、または複数の外部ライブラリをリンクする際に、同一のグローバルシンボルや関数定義が含まれると、リンカはどちらの定義を採用すべきか迷い、LNK2005 エラーが発生します。

また、デバッグ版とリリース版のライブラリや、静的ライブラリと動的ライブラリが混在する場合も同様の問題が生じる可能性があります。

対策と解決方法

宣言と定義の分離

ヘッダーファイルでは変数や関数の宣言のみを行い、実際の定義は1つのソースファイルにまとめることで、重複定義によるエラーを回避することができます。

この場合、extern キーワードを利用して変数の宣言を行い、リンク時に1箇所だけ定義が存在するようにします。

extern宣言の活用方法

以下は、グローバル変数の宣言と定義を分離したサンプルコードです。

1つのヘッダーファイルに extern 宣言を記述し、別のソースファイルで実際の初期化を行います。

#include <stdio.h>
// global.h : ヘッダーファイルには宣言のみ記述する
extern int global_var;
// main.c : 変数の定義と初期化を1箇所で実施する
int global_var = 100;
int main(void) {
    printf("global_var = %d\n", global_var);
    return 0;
}

global_var = 100

この方法により、複数のソースファイルからヘッダーファイルをインクルードしても、実際の変数定義は1箇所のみとなり、エラーを回避できます。

修飾子を利用した定義範囲の限定

定義の影響範囲を限定するために、inline や static といった修飾子を利用することが有用です。

これにより、定義のスコープを制限し、重複定義エラーを未然に防ぐことができます。

inline修飾子の利用事例

関数の定義をヘッダーファイルに記述する必要がある場合は、inline キーワードを付加することで、各オブジェクトファイル毎に同一の関数が生成されても、リンカは同一の関数として認識し、エラーを回避することができます。

以下はその一例です。

#include <stdio.h>
// ヘッダーファイル内で inline 関数として定義
inline int multiply(int num) {
    // 簡単な計算を実施
    return num * 3;
}
int main(void) {
    printf("multiply(4) = %d\n", multiply(4));
    return 0;
}

multiply(4) = 12

static修飾子の利用方法

static 修飾子を用いることで、変数や関数の定義を現在のオブジェクトファイル内に限定することが可能です。

これにより、別のソースファイルに同名の static 定義があっても、リンカはそれぞれを別のシンボルとして取り扱います。

#include <stdio.h>
// static 修飾子により、この変数はこのソースファイル内に限定される
static int local_value = 50;
int main(void) {
    printf("local_value = %d\n", local_value);
    return 0;
}

local_value = 50

プロジェクト設定の見直し

ソースコード側の修正だけでなく、プロジェクトのリンカ設定やコンパイラオプションの調整も、エラー解消に有効な手段です。

特に、不要なライブラリがリンクされていないか、または同一ライブラリの複数のバージョンが混在していないかを確認し、適切な設定を行うことが重要です。

リンカオプションの調整方法

例えば、標準ライブラリと外部ライブラリが混在する場合、コマンドラインオプション /NODEFAULTLIB を利用して、特定の既定ライブラリを無視する設定に変更することができます。

この設定により、不要なライブラリがリンクされるのを防ぎ、シンボルの重複定義を回避する手助けとなります。

IDEのプロジェクト設定画面から、[リンカー]―[入力] の項目で「Ignore Specific Default Libraries」の項目を確認し、対象のライブラリを明示的に除外する設定を行ってください。

原因別具体例

ヘッダーファイルの修正例

ヘッダーファイル内に直接定義を記述する場合、ファイルを複数に分割し、定義を1箇所にまとめることで、重複を防ぐことができます。

この手法は、プロジェクトが大規模化した場合にも有効です。

ファイル分割による重複回避策

例えば、グローバル変数の定義が複数回行われる場合、以下のようにファイルを分割して記述します。

・ global.h (ヘッダーファイル)：変数の宣言のみ

・ global.c (ソースファイル)：変数の定義と初期化

この方法により、複数のソースファイルで global.h をインクルードしても、実際の定義は global.c に1度のみ存在するため、リンカエラーが発生しません。

ライブラリリンク設定の調整例

外部ライブラリ同士のシンボルが重複する場合、ライブラリのリンク順序を見直す、または不要なライブラリを除外する設定を行うことで解決できる場合があります。

/NODEFAULTLIBオプションの適用方法

特定のプロジェクトで、異なるバージョンのCRTライブラリや標準ライブラリが混在してリンクされると、同一シンボルが複数回含まれる可能性があります。

この場合、コンパイラのコマンドラインオプションまたはIDEのプロパティで /NODEFAULTLIB オプションを指定し、対象のライブラリを除外することが有効です。

例えば、Visual Studio のプロジェクト設定で [リンカー]―[入力] の [Ignore Specific Default Libraries] に対象ライブラリ名を追加することで、問題の発生を防ぐことができます。

これらの対策により、定義の重複による LNK2005 エラーを効果的に解決できる可能性があります。

まとめ

本記事では、C言語におけるLNK2005エラーの原因とその解決方法について解説しました。

ヘッダーファイルでのグローバル変数や非inline関数の定義重複、複数ライブラリ間での定義衝突が発生するケースを説明し、extern宣言を用いた宣言・定義の分離、inlineやstatic修飾子による定義範囲の限定、リンカオプションの調整などの対策を紹介しました。

これにより、重複定義エラーの根本的な原因を把握し、具体的な修正方法を学ぶことができます。