【入門編】変数のスコープを最小化する：ブロックレベルでの変数宣言とコードの局所化 – Excel VBA解析バイブル

VBAの「プロシージャ冒頭で全変数宣言」という古い呪縛を解こう

こんにちは。VBAの世界へようこそ。
もしあなたが今、「VBAを書くときは、まずプロシージャの先頭に `Dim i As Long` とか `Dim ws As Worksheet` をズラリと並べるものだ」と教わっているなら、今日でその考え方をアップデートしましょう。

かつて、メモリが潤沢ではなかった時代の名残で「変数は全部最初に宣言せよ」という文化がありました。しかし、現代のプログラミングにおいて、それは「可読性を下げ、バグの温床を作る」行為に他なりません。

今日は、なぜ変数を「使う直前」に宣言すべきなのか。その本質的な理由と、プロの設計思想を解説します。

—

なぜ「冒頭一括宣言」は悪手なのか？

例えば、100行を超える長いプロシージャを書いたとします。先頭で宣言された変数は、最後まで「生き残り」続けます。

• 脳のメモリ負荷: 「この変数、結局どこで使われてるんだっけ？」とスクロールして確認する必要があります。
• 変数の汚染: 途中で似たような名前の変数を再利用してしまい、意図しない値が入ってバグを引き起こすリスクが高まります。
• ライフサイクルの肥大化: 厳密にはVBAの仕組み上、変数の寿命はプロシージャ終了までですが、論理的な寿命を短く保つことは「きれいなコード」への第一歩です。

—

「使う場所で宣言する」という思想

変数の宣言を「使う場所の直前」に寄せることで、その変数の「役割」と「寿命」を視覚的に閉じ込めることができます。

比較してみよう

【Bad】古い慣習的な書き方

Sub OldStyle()
Dim i As Long
Dim ws As Worksheet
Dim lastRow As Long

‘ … ここに50行の別の処理が続く …

‘ やっとここで登場
Set ws = ThisWorkbook.Sheets(“Data”)
lastRow = ws.Cells(Rows.Count, 1).End(xlUp).Row

For i = 1 To lastRow
‘ … 処理 …
Next i
End Sub

これだと、`ws`や`lastRow`の定義が、実際の利用箇所から遠すぎますよね。

【Good】現代的な局所化（Scope Minimization）

Sub ModernStyle()
‘ 処理の途中で使うものは、その直前で宣言する

‘ 1. シートを特定する処理
Dim targetSheet As Worksheet
Set targetSheet = ThisWorkbook.Sheets(“Data”)

‘ 2. ループの直前で変数を宣言
Dim lastRow As Long
lastRow = targetSheet.Cells(targetSheet.Rows.Count, 1).End(xlUp).Row

Dim i As Long
For i = 1 To lastRow
‘ … 処理 …
Next i
End Sub

どうでしょう。`targetSheet`が必要な理由、`lastRow`が必要な理由が、コードを読んだ瞬間に脳に入ってきませんか？

—

現場で役立つ「ブロック・スコープ」の意識

VBAには厳密なブロックレベルのスコープ（`If`や`For`の中だけで有効な変数）は存在しませんが、「視覚的に意味のある範囲に閉じ込める」ことは可能です。

プロが実践するコードの構造化

複雑な処理は、一つの大きなプロシージャに詰め込まず、小さなプロシージャに分割しましょう。そうすることで、変数のスコープを物理的に最小化できます。

Sub MainTask()
‘ 必要なデータを準備する
Dim data As Variant
data = GetTargetData()

‘ 加工する
Call ProcessData(data)
End Sub

‘ 処理を分割すれば、変数「i」などはこの中でしか生きられない
Private Sub ProcessData(ByVal data As Variant)
Dim i As Long
For i = LBound(data) To UBound(data)
‘ ここでしか「i」は存在しない（他の処理には影響を与えない）
Next i
End Sub

—

注意点：陥りやすいエラー

ただし、一つだけ気をつけてください。「使う直前で宣言する」といっても、「ループの中で同じ変数を何度も宣言する」のはNGです。

‘ これはダメ！
For i = 1 To 10
Dim temp As String ‘ ループのたびにメモリ確保が走る可能性がある
temp = “Test”
Next i

あくまで「そのプロシージャ内での、論理的な最初の利用箇所」で宣言してください。

—

まとめ：あなたのコードを「呼吸」させる

変数のスコープを最小化することは、コードに呼吸をさせることと同じです。

1. 宣言は「使用箇所」の近くへ。
2. 長いプロシージャは分割して、変数の生存範囲を物理的に狭める。
3. 変数の名前が役割を語るようにする。

これらを意識するだけで、あなたの書くVBAは「動けばいいコード」から「保守しやすく美しい設計」へと劇的に進化します。

「ここをクリアすれば、VBAの基本はバッチリ」です。ぜひ、今日書くコードから一つだけ、宣言の場所を変えてみてください。その小さな変化が、やがて巨大な自動化システムを支える堅牢な礎になります。

また何か壁にぶつかったら、いつでもここへ戻ってきてくださいね。応援しています！