CS0～400

C# コンパイラエラー CS0136 の原因と対処法について解説

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

CS0136はC#のコンパイラエラーで、内側のスコープで外側のスコープと同じ名前のローカル変数や定数を宣言した際に発生します。

これにより、意図しない変数の隠蔽が起こる可能性があるため、各変数には一意の名前を付ける必要があります。

目次から探す

C#における変数スコープの理解
- スコープの基本
- 変数宣言時の名前競合のルール
CS0136エラーの原因詳細
- エラー発生の背景
- スコープ管理の注意点
CS0136エラーの対処方法
まとめ

C#における変数スコープの理解

スコープの基本

ローカルスコープと入れ子スコープの違い

C#では、ブロック(中括弧「{ }」で囲んだ部分)ごとに変数の有効範囲、つまりスコープが決まります。

ブロック内で宣言された変数は、そのブロック内のみ参照可能です。

外側のブロックで宣言された変数は、入れ子になった内側のブロックからも参照できますが、内側のブロックで同じ名前の変数を宣言すると、外側の変数が隠蔽されてしまい、エラーが発生する可能性があります。

以下のサンプルコードは、ローカルスコープと入れ子スコープの違いを示しています。

外側の変数「counter」は、内側のブロックでも利用できますが、内側で別の変数名「innerCounter」を使って区別することが推奨されます。

using System;
namespace ScopeExample
{
    public class Program
    {
        public static void Main()
        {
            // 外側のスコープで変数を宣言
            int counter = 10;
            Console.WriteLine("外側の[counter]の値: " + counter);
            {
                // 入れ子スコープ内で新たな変数を宣言
                int innerCounter = 20;
                Console.WriteLine("内側の[innerCounter]の値: " + innerCounter);
                // 外側の[counter]も引き続き利用可能
                Console.WriteLine("内側から見た外側の[counter]の値: " + counter);
            }
        }
    }
}

外側の[counter]の値: 10
内側の[innerCounter]の値: 20
内側から見た外側の[counter]の値: 10

変数の有効範囲の確認方法

変数の有効範囲は、宣言したブロックからその閉じ括弧までです。

コードを記述する際は、各変数が定義されるブロックの開始と終了を意識することで、エラーや予期せぬ動作を防止できます。

開発環境の機能(たとえばVisual Studioのアウトライン機能や変数ハイライト機能)を利用すると、どのスコープ内で変数が有効であるかを視覚的に確認できるので便利です。

変数宣言時の名前競合のルール

同一スコープ内での変数宣言の制限

同一のブロック内で同じ名前の変数を複数回宣言することはできません。

たとえば、以下の例では同じブロック内で変数numberを2回宣言しようとしているため、コンパイラエラーが発生します。

using System;
namespace NameConflict
{
    public class Program
    {
        public static void Main()
        {
            int number = 5;
            // 以下の変数宣言は無効です。同じスコープ内で重複宣言はできません。
            // int number = 10;   // エラーの原因となる
            Console.WriteLine("numberの値: " + number);
        }
    }
}

名前の隠蔽とその影響

外側のブロックで宣言された変数と同じ名前を、入れ子の内側のブロックで宣言すると、外側の変数が隠蔽(シャドウイング)されます。

C#の仕様では、入れ子になったローカル変数宣言領域において、外側で既に宣言されている変数と同じ名前を使うことはエラーとなるように設計されています。

これにより、プログラマが意図せずに前の値を上書きしてしまうリスクを軽減できます。

以下の例は、内側のブロックで同じ名前を使用するとエラーが発生するケースを示しています。

using System;
namespace ShadowingExample
{
    public class Program
    {
        public static void Main()
        {
            int value = 100;
            {
                // 以下の行はコンパイラエラー CS0136 を発生させます。
                // int value = 200;  // 外側の[value]を隠蔽してしまうのでエラーになります
                // 代わりに、内側の変数は別名で宣言する必要があります。
                int innerValue = 200;
                Console.WriteLine("内側の[innerValue]の値: " + innerValue);
            }
            Console.WriteLine("外側の[value]の値: " + value);
        }
    }
}

CS0136エラーの原因詳細

エラー発生の背景

内側スコープでの重複宣言の具体例

CS0136エラーは、内側のスコープで外側のスコープで既に宣言されている変数と同じ名前を使用して再度宣言しようとした場合に発生します。

Microsoftのドキュメントでも説明されている通り、入れ子になったブロック内で同じ名前の変数を定義することは、コードの可読性と意図の明確さを損なう原因になるため、コンパイル時にエラーが出る仕様です。

以下の例は、内側のブロックで変数dataを再宣言しようとするため、CS0136エラーが発生するケースを示しています。

/*
using System;
namespace CS0136ErrorExample
{
    public class Program
    {
        public static void Main()
        {
            string data = "外側のデータ";
            {
                // 次の行はCS0136エラーを発生させます。
                // string data = "内側のデータ";  // エラー: 変数の名前が衝突しています
                Console.WriteLine(data);
            }
        }
    }
}
*/

エラーメッセージの解説

CS0136エラーのメッセージは、「ローカルの変数 ‘変数名’ をこのスコープで宣言することはできません」と表示されます。

これは、すでに外側または同一スコープで定義されている変数名と競合しているため、意図しない上書きや混乱を避ける目的で発生されます。

エラーメッセージは、具体的にどの変数名が問題であるかを教えてくれるため、修正時の手がかりとなります。

スコープ管理の注意点

入れ子構造における変数名管理のポイント

入れ子構造でコードを記述する際は、以下のポイントに注意することで変数名の競合を避けることができます。

・変数名はブロックの役割や目的を表すような名前にする

・同じブロック内、または入れ子ブロック内で無理に同じ名前を使わない

・外側のスコープで必要な変数の名前は、入れ子スコープ内では他の名前に変更する

これらの対策により、エラーCS0136を未然に防ぐことができます。

名前空間とスコープの関連性

名前空間は、主にクラスやメソッドなどの大枠の管理単位ですが、変数のスコープは名前空間の中の個々のブロック内で決定されます。

名前空間が同じでも、各メソッドは独立したスコープを持つため、変数名が衝突することは通常ありません。

しかし、メソッド内部でブロックを分ける際に、同じ変数名を使ってしまうとCS0136エラーとなるため、注意が必要です。

CS0136エラーの対処方法

エラー修正のアプローチ

変数名変更による回避策

CS0136エラーが発生した場合、最も簡単な対処法は変数名を変更することです。

内側のスコープ内で宣言する変数は、外側で既に使われている名前と重複しない別の名前にすることで、エラーを解消できます。

変更する際は、変数の役割がわかるような名前にすると、コード全体の可読性が向上します。

スコープ再設計の手法

場合によっては、変数宣言の位置やブロックの構造自体を見直す必要があることもあります。

たとえば、本来別々のブロックで管理すべき変数が同じスコープ内で扱われるようになっている場合、コードのロジックを整理して、意図したスコープ内で変数が宣言されるように再設計するとエラーを解消できます。

コード例で確認する修正事例

修正前後のコード比較

以下に、CS0136エラーが発生する修正前のコードと、エラーを解消した修正後のコードを示します。

修正前のコード

以下はコンパイル時にCS0136エラーが発生する例です。

/*
using System;
namespace CS0136BeforeFix
{
    public class Program
    {
        public static void Main()
        {
            // 外側の変数を宣言
            int index = 0;
            {
                // 内側スコープで同じ名前の変数を宣言してしまい、エラーが発生する
                // int index = 1; // CS0136エラー
                Console.WriteLine("内側から見たindex: " + index);
            }
            Console.WriteLine("外側のindex: " + index);
        }
    }
}
*/

修正後のコード

修正後は、内側で新たな変数名を使用してエラーを回避しています。

using System;
namespace CS0136AfterFix
{
    public class Program
    {
        public static void Main()
        {
            // 外側の変数を宣言
            int index = 0;
            {
                // 内側では別名の変数を宣言することでエラーを回避する
                int innerIndex = 1;
                Console.WriteLine("内側から見たinnerIndex: " + innerIndex);
            }
            Console.WriteLine("外側のindex: " + index);
        }
    }
}

内側から見たinnerIndex: 1
外側のindex: 0

エラー解決後の動作確認手順

修正後は、コンパイルが正常に完了し、以下の手順で動作確認を行ってください。

プロジェクトをビルドして、コンパイルエラーが解消されたことを確認します。
実行して、想定通りに変数が各ブロックで適切に動作していることをチェックします。
出力結果が期待した値となっている場合、エラーが正しく修正されたと判断できます。

以上の内容を踏まえ、CS0136エラーがなぜ発生するのか、またどのように対処すればよいのか、実際のコード例を通して理解できるようになりました。

まとめ

この記事では、C#における変数のスコープ管理と、同一スコープ内での名前衝突が引き起こすCS0136エラーの原因・背景を解説しました。

ローカルスコープと入れ子スコープの違いや、変数の有効範囲の確認方法について理解でき、エラー発生時の具体例やエラーメッセージの内容も説明しています。

また、エラー回避のための変数名変更やスコープ再設計の方法、実際のコード例を通じた修正手順により、問題解決に必要な知識と対処方法を学ぶことができました。