スコープ

概要（サマリー）

スコープとは、プログラム内で変数や関数が参照・使用できる有効な範囲のことである。

スコープの外から変数を参照しようとすると、「変数が定義されていない」というエラーになる。AIが生成したコードで「○○ is not defined」というエラーが出たとき、スコープの問題である可能性が高い。

詳細解説

スコープの基本

スコープは、変数や関数の「見える範囲」を決める仕組みである。ある場所で定義した変数が、別の場所から使えるとは限らない。プログラムは、現在の場所から見える範囲の中で変数を探す。

この仕組みがあることで、別々の処理で同じ名前の変数を使っても衝突しにくくなる。一方で、スコープの外にある変数を使おうとすると、is not defined のようなエラーにつながる。

グローバルスコープ

グローバルスコープとは、プログラム全体のどこからでも参照できる範囲のことである。関数の外で定義した変数はグローバルスコープに属する。

グローバル変数は便利だが、どこからでも変更できるため、値の変化を追いにくくなる。小さなサンプルでは問題になりにくいが、コードが大きくなるほどバグの原因になりやすい。

ローカルスコープ

ローカルスコープとは、関数やブロックなど、特定の範囲の内側だけで有効な範囲のことである。関数の中で定義した変数は、その関数の外からは参照できない。

const globalValue = 'グローバル';

function myFunc() {
  const localValue = 'ローカル';
  console.log(globalValue); // 参照できる
  console.log(localValue);  // 参照できる
}

console.log(globalValue); // 参照できる
console.log(localValue);  // エラー：localValue is not defined

この例では、globalValue は関数の外で定義されているため参照できる。一方、localValue は myFunc() の中で定義されているため、関数の外では見えない。

let / const / var のスコープの違い

JavaScriptには変数宣言の方法が3種類あり、スコープの範囲が異なる。

宣言方法	スコープの種類
var	関数スコープ（関数単位で有効）
let	ブロックスコープ（{} 単位で有効）
const	ブロックスコープ（{} 単位で有効、再代入不可）

var は {} だけではスコープを作らないため、if や for の中で宣言しても外側から参照できることがある。現在のJavaScriptでは、意図しない動作を防ぐために var より let や const を使うことが推奨されている。AIが生成するコードも基本的に let / const を使っていることが多い。

if (true) {
  let blockValue = 'ブロック内だけ';
  const fixedValue = 'これもブロック内だけ';
}

console.log(blockValue); // エラー：blockValue is not defined
console.log(fixedValue); // エラー：fixedValue is not defined

let と const は {} の内側だけで有効になる。if、for、関数などの範囲を意識して変数を定義すると、思わぬ上書きや参照ミスを防ぎやすい。

スコープエラーの見つけ方

ReferenceError: xxx is not defined のようなエラーは、変数が現在のスコープから見えていないときによく出る。変数名のスペルミス、定義する前に使っている、関数の中で定義した変数を外で使っている、などが典型的な原因である。

エラーが出たら、まず「その変数はどこで定義されているか」「使っている場所から見える範囲にあるか」を確認する。開発者ツールのConsoleに表示される行番号を見て、変数を使っている場所と定義している場所を比べるとよい。

AIコーディングとスコープの関係

AIが生成したコードでは、関数の外に出したい値が関数内だけで定義されていたり、別のブロック内で定義した変数を後から参照していたりすることがある。その場合、スコープの理解がないと「なぜ見えないのか」が分かりにくい。

AIに修正を頼むときは、エラーメッセージと該当する変数名、変数を定義している場所、使っている場所を一緒に伝えるとよい。「この変数のスコープが原因か確認してください」と聞くと、問題を絞り込みやすい。

よくある勘違い

グローバル変数を多用してよい？

グローバルスコープに変数をたくさん置くと、どこで値が変更されるか追いにくくなり、バグの原因になりやすい。必要な範囲だけでアクセスできるように、できるだけ狭いスコープで変数を定義するのがよい書き方だ。

関数の外から中の変数を読める？

関数の中で定義した変数は、その関数の外からは基本的に参照できない。外でも使いたい値は、関数の戻り値として返す、または外側のスコープで定義するなど、意図が分かる形にする必要がある。

{} はいつも同じスコープを作る？

JavaScriptでは、let と const は {} によるブロックスコープを作る。一方、var は関数スコープなので、if や for の {} だけでは同じように閉じ込められない。この違いが混乱の原因になりやすい。

スコープエラーはAIが勝手に直せる？

AIは修正案を出せるが、どの値をどこで使いたいのかはコードの意図によって変わる。変数を外に出すべきか、関数の引数にするべきか、戻り値にするべきかは、処理の目的に合わせて判断する必要がある。

より詳しくAIに聞いてみよう

• JavaScript の var、let、const のスコープの違いを具体例で教えてください。
• クロージャとスコープの関係を初心者向けに説明してください。
• ReferenceError: xxx is not defined が出る原因をスコープの観点から説明してください。
• 関数の中で作った変数を外で使いたいとき、どんな書き方がありますか？
• AIが生成したコードのスコープエラーを直すとき、どこを確認すればよいですか？