【VBA入門】変数と定数の使い方を徹底解説

そもそもVBAの変数とは？基礎から押さえる

結論から言うと、変数は中身を入れ替えられる箱です
数値や文字を一度しまっておいて、あとから取り出したり書き換えたりできます

変数とは「中身が変わる箱」

イメージとしては、Excelのセルが近いです
セルA1に数値を入れて、あとで別の数値で上書きできるのと同じで、変数も値を入れたり入れ替えたりできる入れ物だと思ってください

たとえば合計金額を計算するなら、計算結果をいったん変数にしまっておいて、あとで表示したりセルに書き戻したりします
セルに直接書き込み続けるより、いったん変数を経由したほうがコードが追いやすくなります

ジャベ雄

最初は「ラベルを貼った箱」くらいの感覚でOKです

変数を使う3つのメリット

なぜわざわざ変数を使うのか、メリットは大きく3つあります

• 処理効率が上がる … 一度計算した値を使い回せるので、同じ計算を何度も書かずに済みます
• 保守しやすい … 値を1か所にまとめておけば、後から直すときもその変数だけ見ればよくなります
• 読みやすい … targetRow のように意味のある名前を付けると、コードが何をしているか一目で伝わります

とくに最後の「読みやすさ」は、あとからじわじわ効いてきます
セルの座標を数字で直書きすると後から見て意味が分からなくなりますが、名前のある変数なら自分にもチームにもやさしいコードになります

変数の書き方(Dimで宣言する)

変数を使う前に「これから使いますよ」と宣言します
基本の形は Dim 変数名 As データ型 です

Dim score As Integer
Dim name As String

Dim は「宣言する」を意味するキーワード、その後ろに自分で決めた変数名、As の後ろにデータ型を書きます
上の例だと、score という整数の箱と、name という文字の箱を用意した、と読めます

データ型は「この箱には何を入れるか」を決める指定です
整数なら Integer、文字なら String といった具合で、種類は後ほどまとめて紹介します

Option Explicitで宣言を強制する

ここが入門者にとって一番の押しどころです
モジュールの先頭に Option Explicit と書いておくと、宣言していない変数を使った瞬間にエラーで教えてくれます

何がうれしいかというと、変数名のタイプミスをコンパイル時に弾いてくれるところです
たとえば targetRow と書くつもりが targetRwo と打ち間違えても、Option Explicit があれば「そんな変数は宣言されてないよ」と止めてくれます

これが無いと、打ち間違えた名前が新しい空っぽの変数として勝手に作られてしまいます
計算が合わないのに原因が分からない、やっかいなバグの温床です

ジャベ雄

私はこれを入れてから、typoバグでハマる回数がぐっと減りました

変数の命名規則(VBA公式ルールと慣習)

変数名は自由に付けられますが、いくつか守るべきルールと、守ると読みやすくなる慣習があります
ここを分けて理解しておくと、名付けで迷いにくくなります

公式の命名ルール

まず、VBAの仕様として決まっている制約はこちらです

• 先頭は文字(アルファベットや日本語)で始める、数字や記号からは始められません
• スペースや一部の記号(.(ピリオド)! @ & $ #)は使えません
• 長さは255文字以内に収めます
• VBAの関数名やステートメント名と同じ名前(予約語)は避けます
  衝突するので別の名前にします

予約語については「使えない」より「避ける」が正確です
たとえば Date のような語と同じ名前を付けると意味が衝突するので、別の名前にしておくのが無難です

よく使う命名スタイル

次は慣習の話です
変数名の付け方にはいくつか流派があって、どれもルールではなく読みやすさのための慣習です

Dim targetRow As Long   ' ---キャメルケース
Dim lngRow As Long      ' ---ハンガリアン記法
Dim target_row As Long  ' ---スネークケース 
Dim TargetRow As Long   ' ---パスカルケース
Dim 対象行 As Long       ' ---日本語は非推奨

• キャメルケース … 2語目以降の頭を大文字に(targetRow)、読みやすく人気のスタイル
• ハンガリアン記法 … 型を示す接頭辞を付ける(lngRow なら Long)、ひと目で型が分かります
• スネークケース … 単語をアンダースコアでつなぐ(target_row)
• パスカルケース … すべての単語の頭を大文字に(TargetRow)
• 日本語 … 動きはしますが文字化けや入力切替の手間があり非推奨です

大事なのは、どれが正解かではなく1つのプロジェクトで統一する点です
キャメルケースとハンガリアン記法が混ざっていると逆に読みにくくなるので、自分なりのルールを決めて揃えると安心です

ジャベ雄

こんなのもあるんだー、くらいでまずは大丈夫です

変数のスコープ(適用範囲)を理解する

スコープとは、その変数がどこまで使えるかという範囲のことです
結論を先に言うと、宣言する場所によって「使える範囲」が変わります

宣言する場所による違い

変数を宣言する場所はざっくり2か所あります
プロシージャ(Sub や Function)の中で宣言するか、モジュールの先頭(どのプロシージャよりも前)で宣言するかです

プロシージャの中で Dim したローカル変数は、そのプロシージャを抜けると消えます
逆にモジュールの先頭で宣言すると、そのモジュールの複数のプロシージャから同じ変数を共有できます

PrivateとPublicステートメント

モジュールの先頭で宣言するとき、Private と Public で公開範囲を変えられます
違いは、他のモジュールから触れるかどうかです

ちなみに、モジュールの先頭で Dim をそのまま使うと、これは Private と同じ扱いになります
つまり同じモジュール内からは使えるけれど、他のモジュールからは触れません

もう1つ覚えておくと便利なのが Static です
プロシージャ内で Static を使って宣言すると、プロシージャを抜けても値が残ります
呼び出すたびに1ずつ増えるカウンターを作りたいときに使えます

ジャベ雄

まずは「Dim=その場だけ」「Public=全体で共有」を押さえればOKです

📚 VBAの独学に効く本PR

Excel VBA塾【動画×本で学ぶ!】

たてばやし淳

Amazonで見る楽天で見る

パーフェクトExcel VBA

高橋宣成

Amazonで見る楽天で見る

Excel マクロ&VBA［実践ビジネス入門講座］完全版 第3版

国本温子

Amazonで見る楽天で見る

私のおすすめからランダムで3冊を表示しています

VBAのデータ型一覧と選び方

データ型は「この箱に何を入れるか」を決める指定です
適切な型を選ぶと、メモリの無駄が減り、想定外の値が入るのを防げます

基本的なデータ型

まずは入門でよく使う型をまとめました
全部覚える必要はなく、最初は Long(整数)String(文字)Double(小数)あたりを押さえれば十分です

お金の計算をするなら Currency が向いています
小数点以下4桁で固定されるので、Double で起きがちな小さな誤差が出にくく、金額の足し引きに強いです

Boolean と Date の初期値には「※」を添えています
これは公式に「初期値はこれ」と名指しされているわけではなく、挙動上 Boolean は False、Date はシリアル値0として扱われる、という意味の注記です

オブジェクト型とSet

セルやワークブックそのものを変数に入れたいときは、オブジェクト型を使います
このとき普通の = ではなく Set から始めるのがポイントです

Dim name As String
Dim wb As Workbook

name = "ジャベ雄"
Set wb = Thisworkbook ' ---オブジェクトへの代入はSetから始める

文字や数値はそのまま = で代入できますが、ワークブックやワークシートのようなオブジェクトは Set を付けないと代入できません
うっかり Set を忘れるとエラーになるので、オブジェクトには Set とセットで覚えておくと安心です

なお、オブジェクト型の変数はまだ何も入れていない状態だと Nothing(どのオブジェクトも参照していない)になります
Set で実際のオブジェクトを代入してはじめて使えるようになります

万能型のVariantとObject

Variant は何でも入る万能型です
データ型を指定しない(As を省略する)と、原則この Variant が割り当てられます

便利そうに見えますが、Variant は基本的に避けたい型です
型が決まっていないぶん想定外の値が入りやすく、typo にも気づきにくくなります
配列を柔軟に扱いたいときなど、必要な場面に絞って使うのがおすすめです

列挙型(Enum)とユーザー定義型(Type)

少し発展的な型として、Enum と Type も紹介しておきます
こんなのもあるんだー、ぐらいで読み飛ばしてもらって大丈夫です

まず Enum(列挙型)は、関連する数値に名前を付けてまとめられる型です
曜日や区分のように、決まった選択肢を分かりやすく扱いたいときに便利です

Enum WeekDay
    Sunday      ' 0
    Monday      ' 1
    Tuesday     ' 2
    Wednesday   ' 3
    Thursday    ' 4
    Friday      ' 5
    Saturday    ' 6
End Enum

Sub ShowDay()
    MsgBox "今日の曜日は: " & WeekDay.Monday  ' 結果は「1」
End Sub

次に Type(ユーザー定義型)は、複数のデータを1つにまとめた自作の型です
下の例だと、名前・年齢・給与をひとかたまりの「従業員」として扱えます

Type Employee
    Name As String
    Age As Integer
    Salary As Double
End Type

Sub ShowEmployee()
    Dim emp As Employee
    emp.Name = "田中 太郎"
    emp.Age = 30
    emp.Salary = 5000000

    MsgBox "氏名: " & emp.Name & vbCrLf & _
           "年齢: " & emp.Age & vbCrLf & _
           "給与: " & emp.Salary & "円"
End Sub

このあたりは慣れてきてから使えば十分です
最初は基本のデータ型を使いこなすところを優先しましょう

定数(Const)の使い方

定数は、一度決めたら中身が変わらない箱です
変数が「入れ替えられる箱」なのに対して、定数は「最初に決めた値で固定する箱」だと考えてください

定数とは(変わらない値)

たとえば消費税率や、決まった上限値のように、プログラムの途中で変わってほしくない値を入れるのに向いています
定数は宣言時に値を確定させ、その後は書き換えられません

定数を使うメリット

• 安全 … 実行中にうっかり書き換わる心配がありません
• 一括変更できる … 値を1か所にまとめておけば、変更があってもそこだけ直せば済みます
• 読みやすい … 0.1 のような数字を直書きするより、TAX_RATE のような名前のほうが意味が伝わります

ここで大事になるのがマジックナンバーの回避です
0.1 や 100 のようにコードへ直接書かれた意味の分かりにくい数字をマジックナンバーと呼びますが、TAX_RATE のような定数に置き換えると、名前そのものが値の説明になってくれます

ジャベ雄

「あちこちに同じ数字を直書きしてた…」が無くなるのは大きいです

定数の書き方

定数の宣言は Const 名 As 型 = 値 の形です
変数の Dim と違い、宣言と同時に値まで決めてしまうのが特徴です

Const score As Integer = 100
Const name As String = "ジャベ雄"

定数の式には、ほかの定数やリテラル(直接書いた数値や文字)、四則演算は使えますが、変数や関数は使えません
あくまで「最初に確定できる値」だけを入れる、と覚えておくと迷いません

定数にもスコープがあります
モジュールの先頭で宣言して Public を付ければ他のモジュールから使えますが、プロシージャの中で書いた定数はそのプロシージャの中だけで、公開範囲は変えられません

定数の命名規則

定数は変数と区別しやすいよう、すべて大文字+アンダースコアで書く慣習があります
これも仕様ではなく慣習ですが、コードの中で「ここは固定値だな」と一目で分かるので便利です

Const MAX_USER_COUNT As Integer = 100
Const DEFAULT_FONT_SIZE As Double = 12.5
Const API_ENDPOINT_URL As String = "https://example.com/api"

このように大文字で書いておくと、後からコードを読んだときに変数と定数がすぐ見分けられます
小さな工夫ですが、保守のしやすさにつながります

変数・定数のよくある質問(FAQ)

最後に、初心者の方からよく出る疑問をまとめました
つまずきやすいポイントなので、気になるところだけでも目を通してみてください

まとめ

VBAの変数と定数を一通り見てきました
最後に押さえておきたいポイントを振り返ります

• 変数は中身が変わる箱、定数は中身を固定する箱
• 宣言は Dim 変数名 As データ型、型を指定すると無駄やミスが減る
• モジュール先頭に Option Explicit を入れて宣言を強制し、typo を防ぐ
• スコープ(使える範囲)は宣言する場所で決まる

変数の代表的な使いどころのひとつが、ループのカウンター変数です
繰り返し処理で「今が何回目か」を数えるのに変数を使うので、変数になじんだらVBAのループ処理もあわせて読むと、コードの幅がぐっと広がります

ジャベ雄

まずは Dim と型、Option Explicit から始めてみてくださいね

📚 VBAの独学に効く本PR

Excel VBA塾【動画×本で学ぶ!】

たてばやし淳

Amazonで見る楽天で見る

パーフェクトExcel VBA

高橋宣成

Amazonで見る楽天で見る

Excel マクロ&VBA［実践ビジネス入門講座］完全版 第3版

国本温子

Amazonで見る楽天で見る

私のおすすめからランダムで3冊を表示しています