【VBA】変数をまとめて宣言する方法

5月 4, 2025

Excel VBAにおいて、効率的なコーディング実践の一環として、変数をまとめて宣言する方法は、コードの可読性と保守性を向上させる上で非常に役立ちます。
この記事では、変数をまとめて宣言するいくつかの方法と、それらを活用する際のベストプラクティスを解説します。

単一のDimステートメントで複数の変数宣言

VBAでは、複数の変数を一行で宣言することが可能です。これにより、コードの冗長性を減らし、宣言部分の可読性を高めることができます。
ただし、この方法では、すべての変数に同じデータ型が割り当てられます。

Dim x, y, z As Integer

【注意点】
上記の宣言ではzのみがInteger型として宣言され、xとyはVariant型（VBAのデフォルトのデータ型）となります。
各変数に明確にデータ型を割り当てたい場合は、以下のように各変数に対して型を指定する必要があります。

Dim x As Integer, y As Integer, z As Integer

関連する変数は、論理的なブロックまたはセクションでグルーピングすることで宣言すると良いでしょう。これにより、コードの構造が明確になり、後で特定の変数群を見つけやすくなります。

' ユーザー情報に関する変数
Dim userName As String, userId As Long, userAge As Integer

' 計算用の変数
Dim sum As Double, average As Double, total As Double

複数のプロシージャや関数で共有される変数は、モジュールレベル（プロシージャの外側）で宣言することが推奨されます。これにより、同じ変数を複数の場所で再宣言する必要がなくなり、コードの整理が容易になります。【VBA】Dim・Private・Publicの使用方法

Private userCount As Integer, lastLogin As Date

明示的なデータ型の指定: Variant型は便利ですが、パフォーマンスに影響を与える可能性があるため、可能な限り明示的なデータ型を指定することをお勧めします。

【命名規則の使用】
変数名は、その用途や内容を明確に示すようにしてください。例えば、カウンタはcntやindexのように、文字列はsNameやstrNameのように命名すると良いでしょう。

【Option Explicitの使用】
モジュールの先頭にOption Explicitを宣言することで、すべての変数を明示的に宣言する必要があります。これにより、未宣言の変数によるタイプミスや予期しないエラーを防ぐことができます。

Option Explicit

Sub MySub()

Dim myVar As Integer
myVar = 10
' 以下のように未宣言の変数を使用するとエラーになる
' myVar2 = 20

End Sub