CS0～400

C#コンパイラエラー CS0165 について解説：未初期化ローカル変数のエラーと対策を紹介

2025-03-29更新日: 2025-03-29

CS0165はC#のコンパイル時エラーで、初期化されていないローカル変数を使用した場合に発生します。

変数に必ず初期値を設定することで、エラーの発生を防ぐことができます。

ソースコードを見直し、すべての変数が正しく初期化されているか確認することが重要です。

目次から探す

エラー発生の背景と原因
- C#における変数初期化ルール
- エラーが発生する状況
エラー発生コード例の検証
- 未初期化変数の利用例
- 委任定義におけるエラー例
エラー解消の対策
- 変数初期化の具体的手法
- コード修正実例の検証と注意点
まとめ

エラー発生の背景と原因

C#では、ローカル変数は必ず初期化される必要があります。

初期化されない状態で変数を利用すると、思わぬ動作を引き起こす可能性があるため、コンパイラが安全性を確保するためにエラー(CS0165)を出す仕組みとなっています。

C#における変数初期化ルール

未初期化ローカル変数の定義と制約

C#の仕様では、ローカル変数は宣言後に必ず初期化された状態で利用されなければなりません。

これにより、変数が予期せぬ値を持ったまま使用されることを防止します。

たとえば、条件分岐などで一部のパスでしか初期化されない場合、他のパスで利用されるとエラーが発生します。

コンパイラは、各変数に対してすべての実行パスで確実に値が割り当てられているかを静的解析し、初期化が保証されていないと判断した場合にエラー(CS0165)を出すため、常に全パスにわたる初期化が必要となります。

コンパイラによるエラー検出の仕組み

C#コンパイラは、定義された変数に必ず値が割り当てられるかをチェックしています。

この解析は、ソースコード内のすべての分岐パス(if文、switch文、ループなど)を網羅的に確認し、どのパスでも変数が初期化されているかを判断します。

もし、初期化されない可能性があるパスが存在すると、コンパイラはエラー CS0165 を出力します。

たとえば、条件分岐の一方で初期化が行われず、その後で変数を使用する場合などです。

また、再帰的な委任(delegate)の定義でも、変数が初期化される前にその変数が利用されるとエラーとなるケースがあります。

エラーが発生する状況

条件分岐による初期化漏れのパターン

条件分岐を使用したコードでは、必ずしもすべての分岐で変数が初期化されるとは限りません。

たとえば、if文のみで初期化して、else分岐で初期化しない場合、if条件が偽のときに変数が初期化されず、その後の処理で変数が参照されるとエラー CS0165 が発生します。

このような場合は、すべての分岐で初期化を行うか、宣言時に初期値を設定するなどの対策が必要です。

再帰的委任定義でのエラー発生例

再帰的な委任の定義においても、同様に変数の初期化が問題となります。

変数を利用して委任を作成する際、変数がまだ初期化されていない状態で参照されると、コンパイラはエラー CS0165 を出力します。

たとえば、以下のようなコードでは、委任の内部から自身を参照するため、変数が初期化される前に利用されることになります。

エラー発生コード例の検証

具体的なコード例を通して、エラーがどのように発生するのか確認していきます。

ここでは、未初期化の変数利用と、委任定義におけるエラー例を示します。

未初期化変数の利用例

次のサンプルコードは、条件分岐により初期化が漏れる可能性のある例です。

この例では、変数iがif分岐内でのみ初期化され、else分岐が存在しないため、iが初期化されない可能性があります。

using System;
class Program
{
    static void Main(string[] args)
    {
        int i, j;
        // 引数が存在し、"test"の場合のみiに値が代入される
        if (args.Length > 0 && args[0] == "test")
        {
            i = 0;
        }
        // elseブロックがないため、iは初期化されない可能性がありエラー CS0165 が発生
        j = i;
        Console.WriteLine(j);
    }
}

委任定義におけるエラー例

以下のサンプルでは、変数dを使用して委任(delegate)を定義する際に、変数が初期化される前に自身を参照しているため、エラー CS0165 が発生します。

using System;
public delegate void Del();
class Program
{
    static void Main(string[] args)
    {
        // dが初期化される前にdを利用しているためエラーとなる
        Del d = delegate()
        {
            Console.WriteLine(d);
        };
        // 実行例としてはd()を呼び出してもエラーが出るため注意
        // d();
    }
}

エラー解消の対策

変数の初期化エラーを解消する方法として、主に宣言時の初期化と、条件分岐内で必ず初期化を行う方法が考えられます。

また、委任の定義においては、初期化と利用を分離することがポイントです。

変数初期化の具体的手法

宣言時の初期化設定

もっとも単純な方法は、変数を宣言すると同時に初期値を設定することです。

これにより、どの実行パスでも変数が初期化されている状態になるため、エラーが発生しません。

using System;
class Program
{
    static void Main(string[] args)
    {
        // 宣言と同時に初期化することでエラーを防ぐ
        int i = 0;
        int j = i;
        Console.WriteLine(j);
    }
}

条件分岐内での初期化確認

条件分岐を利用する場合は、すべての分岐で変数が初期化されるように設計する必要があります。

以下のサンプルコードは、ifとelseの両方で変数iに値を割り当てる例です。

using System;
class Program
{
    static void Main(string[] args)
    {
        int i, j;
        if (args.Length > 0 && args[0] == "test")
        {
            i = 0;
        }
        else
        {
            // elseブロックで初期化する
            i = 1;
        }
        j = i;
        Console.WriteLine(j);
    }
}

0   // args[0] が "test" の場合

1   // args が空もしくは "test" 以外の場合

コード修正実例の検証と注意点

委任(delegate)の定義においては、変数の初期化と利用を分離することが重要です。

以下のサンプルコードは、最初に変数dをnullで初期化し、その後に委任を定義しています。

これにより、再帰的な呼び出しが発生する前に変数が初期化され、安全に利用できるようになります。

using System;
public delegate void Del();
class Program
{
    static void Main(string[] args)
    {
        // まずnullで初期化してから委任を定義する
        Del d = null;
        d = delegate()
        {
            // 委任内では初期化済みのdを参照できる
            Console.WriteLine("Delegate invoked: {0}", d.Method.Name);
        };
        // 修正後の委任を呼び出す
        d();
    }
}

Delegate invoked: Main

まとめ

この記事では、C#のCS0165エラーの発生原因と対策について解説しています。

ローカル変数は必ず初期化される必要があり、不十分な初期化によってエラーが起こる仕組みを理解できます。

条件分岐や再帰的な委任定義でエラーが発生する具体例を確認し、宣言時の初期化やすべての分岐での初期化など、エラー回避の方法を学ぶことができます。