先生と生徒の会話形式で理解しよう

生徒

「Excel VBAでマクロを書き始めたんですが、プロジェクトとかモジュールって何ですか？」

先生

「VBAを使うと必ず出てくる言葉ですね。実は、整理整頓の考え方が分かればとてもシンプルなんです」

生徒

「ファイルとかフォルダみたいなものですか？」

先生

「そのイメージで大丈夫です。では、Excel VBAプロジェクトの中身を順番に見ていきましょう」

1. Excel VBAプロジェクトとは何か

Excel VBAプロジェクトとは、Excelファイルの中に入っているVBAの仕組み全体のことを指します。Excelを一つの家だとすると、VBAプロジェクトはその家の中にある作業部屋のような存在です。

VBAプロジェクトの中には、マクロや設定、Excelを操作するための命令がまとめて保管されています。VBEを開くと左側に表示される「VBAProject（ファイル名）」が、それにあたります。

初心者のうちは、プロジェクトは「VBAを入れておく大きな箱」と考えると分かりやすいです。

2. プロジェクトの中の基本的な構造

Excel VBAプロジェクトの中には、いくつかの部品があります。代表的なものが、標準モジュール、シートモジュール、ThisWorkbookです。

これらは、それぞれ役割が違います。整理整頓された引き出しのように、用途ごとに使い分けることで、VBAが分かりやすくなります。

最初はすべてを完璧に理解する必要はありませんが、「場所によって役割が違う」という意識を持つことが大切です。

3. 標準モジュールの役割を知ろう

標準モジュールは、VBAで一番よく使う場所です。ここには、自分で実行するマクロを書きます。

例えるなら、作業手順を書いたノートのような存在です。ボタンを押したときや、マクロ一覧から実行する処理は、基本的に標準モジュールに書きます。


Sub HelloProject()
    MsgBox "これは標準モジュールのマクロです"
End Sub

このようなシンプルなマクロは、まず標準モジュールに書くのが基本です。

4. シートモジュールとは何をする場所か

シートモジュールは、Excelのシートごとに用意されている特別な場所です。シートに関係する処理を書くために使います。

例えば、「このシートを操作する」「このシートの値を変更する」といった内容に向いています。

初心者のうちは、シートモジュールは「そのシート専用の部屋」と考えると理解しやすくなります。


Sub WriteSheetName()
    Range("A1").Value = "この処理はシートに関係します"
End Sub

5. ThisWorkbookの役割をやさしく理解

ThisWorkbookは、Excelファイル全体に関係する処理を書く場所です。ファイルを開いたときや閉じたときなど、ブック全体に関わる動きをまとめます。

例えるなら、家全体のルールを書いた紙のような存在です。部屋ごとではなく、家全体に影響する内容を扱います。


Sub WorkbookInfo()
    MsgBox "このExcelファイル全体の処理です"
End Sub

6. モジュールを分けて管理する理由

VBAを書き進めていくと、マクロの数が増えてきます。すべてを一つのモジュールに書くと、後から見たときに分かりにくくなります。

そのため、役割ごとにモジュールを分けることが重要です。これは、書類を用途別にファイル分けするのと同じ考え方です。

初心者の段階から、モジュールを整理する習慣をつけると、後で困りにくくなります。

7. モジュールの追加と名前の付け方

VBEでは、右クリックから簡単に標準モジュールを追加できます。追加したモジュールには、分かりやすい名前を付けることが大切です。

例えば、「計算用」「表示用」など、日本語や英単語で意味が伝わる名前にすると管理が楽になります。

名前を付けることは、VBAを読む自分へのメモでもあります。

8. 初心者が意識したいプロジェクト管理のポイント

Excel VBAプロジェクトは、最初は小さく見えても、少しずつ成長していきます。そのため、最初から整理を意識することが大切です。

プロジェクト、モジュール、マクロの関係を理解しておくと、VBAが怖いものではなくなります。

今回の内容を意識しながらVBEを見ると、構造が少しずつ見えてくるはずです。

まとめ

ここまで、Excel VBAにおけるプロジェクトの全体像から、各モジュールの役割、そして効率的な管理方法について詳しく解説してきました。Excel VBAを習得する上で、単に「コードが書ける」ことと同じくらい大切なのが、この「どこに何を書くべきか」というプロジェクト構成の理解です。

多くの初心者が陥りやすい罠として、すべてのプログラムを一つの場所に詰め込んでしまうことが挙げられます。しかし、今回の内容を振り返れば分かる通り、VBAには「標準モジュール」「シートモジュール」「ThisWorkbook」という、明確な役割分担がなされた「部屋」が用意されています。これらを適切に使い分けることで、後からプログラムを見直した際の可読性が劇的に向上し、エラーの特定や機能の追加もスムーズに行えるようになります。

各モジュールの特性と使い分けのポイント

プロジェクト管理をマスターするための要点を、実務的な視点で整理してみましょう。

標準モジュール： プログラムのメイン会場です。汎用的な計算処理や、マクロボタンから呼び出す操作はここに集約します。
シートモジュール： 特定のシートに関連する処理（イベントプロシージャなど）を記述します。そのシートだけで完結する設定などはここが最適です。
ThisWorkbook： ファイルを開いた時（Workbook_Open）や閉じる時など、ブック全体の挙動を制御する司令塔の役割を果たします。

実践的なモジュール管理と命名規則

VBA開発において、モジュール名に「Module1」「Module2」といったデフォルトの名前を使い続けるのは避けたいところです。プロジェクトが大きくなった際に、どこに何の処理があるか分からなくなるためです。実務では、以下のように役割が推測できる名前を付けることが推奨されます。

mod_Main：メインの実行処理
mod_Common：共通して利用する関数やサブルーチン
mod_Import：外部データの取り込みに関連する処理

参考：Office Scriptsとの構造の違い

最近ではExcelの自動化手法として、Web版Excelで動作する「Office Scripts」も注目されています。VBAが「モジュール」という単位でプロジェクトを構成するのに対し、Office ScriptsはTypeScript（TS）をベースとした独立したスクリプトファイルとして管理されます。VBAのプロジェクト構成を理解していれば、新しい技術への移行もスムーズです。参考までに、Office Scriptsでの基本的な書き方も確認しておきましょう。


function main(workbook: ExcelScript.Workbook) {
  // 現在のシートを取得
  let selectedSheet = workbook.getActiveWorksheet();
  // セルA1に値を書き込む
  selectedSheet.getRange("A1").setValue("Office Scriptsでの実行例");
  
  console.log("処理が完了しました。");
}

このように、VBAとOffice Scriptsでは書き方は異なりますが、「オブジェクト（ブックやシート）を操作する」という根本的な考え方は共通しています。

プログラムの保守性を高めるために

最後に、VBAコードを書く際は常に「数ヶ月後の自分や、他人がこのコードを読む」という意識を持ってください。モジュールを適切に分割し、コメントを添えるだけで、そのマクロは単なる「動く道具」から「資産」へと変わります。


'------------------------------------------------------------
' 関数名：CheckUserAge
' 引数  ：intAge (年齢)
' 戻り値：なし
' 概要  ：年齢に応じてメッセージボックスを表示する
'------------------------------------------------------------
Sub CheckUserAge(intAge As Integer)
    If intAge >= 20 Then
        MsgBox "成人として判定されました。", vbInformation
    Else
        MsgBox "未成年として判定されました。", vbExclamation
    End If
End Sub

' 実行用プロシージャ
Sub RunApp()
    Call CheckUserAge(25)
End Sub

上記のコードを標準モジュールに記述し、適切に管理することで、プログラムの再利用性が高まります。実行結果は以下のようになります。


（メッセージボックスに「成人として判定されました。」と表示される）

プロジェクト構成とモジュール管理を意識することは、プログラミングスキルの向上に直結します。まずは「Module1」の名前を変更するところから始めてみましょう。それだけで、あなたのVBA開発環境はぐっとプロフェッショナルなものに近づくはずです。

先生と生徒の振り返り会話

生徒

先生、ありがとうございました！「プロジェクト」っていう言葉を聞くと難しく感じていましたが、要するに「Excelという家の中にある整理棚」のことなんですね。

先生

その通りです。良い例えですね。引き出しが一つしかない棚よりも、中身に合わせてラベルが貼ってある棚の方が、探し物がすぐに見つかりますよね。VBAのモジュール管理も全く同じなんです。

生徒

今まで、全部「Module1」の中にズラーッと書いていました。だから後でどこを直せばいいか分からなくなって、結局最初から作り直すなんてこともあって……。

先生

それは「VBAあるある」ですね（笑）。でも今日からは、シートに関するものはシートモジュールへ、汎用的なものは標準モジュールへ、といった具合に「住所」を決めてあげてください。

生徒

はい！あと、モジュールの名前に日本語を使ってもいいというのは驚きました。英語じゃないといけないと思っていて、つい億劫になっていたんです。

先生

基本的には英数字が推奨されますが、自分やチームのメンバーが直感的に理解できることが最優先です。大切なのは、ルールを決めて一貫性を持たせることですよ。

生徒

なるほど。コードを書く前の「整理整頓」が、結局は時短に繋がるんですね。これからはVBEの左側にあるプロジェクトエクスプローラーをしっかり眺めて、構造を意識しながら作ってみます！

先生

その意気です。構造が美しく整ったプロジェクトは、不具合も出にくいものです。ぜひ、読みやすくてメンテナンスしやすい、プロ級のプロジェクト構成を目指してくださいね。

Excel VBAプロジェクト構成とモジュール管理を完全解説！初心者でも迷わない基本の考え方