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

生徒

「VBAでたくさんのツールを作っているのですが、似たようなコードを何度も書いていて、管理が大変になってきました…。」

先生

「それは『再利用性』を考えるタイミングですね。プロジェクトの構成を工夫して、どこからでも使える『共通パーツ』を作ると劇的に楽になりますよ。」

生徒

「共通パーツですか？初心者でも作れるものなんでしょうか？」

先生

「もちろんです！今日はコードの整理術、つまり『プロジェクト構成戦略』の基本を丁寧に解説しますね。」

1. Excel VBAのプロジェクト構成とは？

Excel VBAを使い始めると、まずは「標準モジュール」という場所にコードを書き込むことからスタートします。しかし、プログラムの規模が大きくなったり、複数のブックで同じような処理が必要になったりすると、あちこちに同じコードが散らばってしまいます。これを放置すると、修正が必要になったときに全ての場所を書き直さなければならず、ミスや手間の原因になります。

プロジェクト構成とは、プログラムを役割ごとに整理整頓する「設計図」のようなものです。本棚に本をジャンルごとに並べるように、VBAのコードも「計算用」「画面表示用」「データの保存用」といった具合に分けて管理することで、どこに何があるか一目でわかるようになります。これを意識するだけで、初心者から一歩抜け出したプロフェッショナルな開発ができるようになります。

2. コードの「再利用性」を高めるメリット

「再利用性」という言葉は少し難しく聞こえるかもしれませんが、要するに「一度作った便利な部品を、別の場所でも使い回せるようにすること」です。料理で例えるなら、毎回一から出汁を取るのではなく、作り置きの「万能つゆ」を作っておくようなイメージです。これには大きなメリットが3つあります。

開発スピードが上がる： 過去に作った部品を組み合わせるだけで、新しいツールが完成します。
間違いが減る： すでに正しく動くことが確認されている部品を使うため、バグ（プログラムのミス）が入り込む隙が少なくなります。
メンテナンスが楽： 万が一、計算式が変わったとしても、共通の部品を1箇所直すだけで、それを使っている全てのツールに反映されます。

パソコンの操作に慣れていない方でも、この「整理整頓のルール」さえ覚えてしまえば、複雑なプログラムもパズルのように組み立てることができるようになります。

3. 標準モジュールを「共通関数」の置き場にする

VBAで最もよく使われるのが「標準モジュール」です。ここに「どこからでも呼び出せる便利な道具箱」を作ります。これを共通関数と呼びます。例えば、「消費税を計算する」という処理は、請求書作成でも売上管理でも使いますよね。これを一つのモジュールにまとめておきます。

まずは、非常にシンプルな共通関数の例を見てみましょう。このコードは、指定した数値に消費税10%を加えて返すというものです。


' 共通関数をまとめるモジュール（Module_Commonなどと名前を付けると分かりやすい）
Function GetTaxPrice(price As Long) As Long
    ' 消費税10%を計算して足す処理
    GetTaxPrice = price * 1.1
End Function

' 実際に使う側のコード
Sub MainProcess()
    Dim total As Long
    ' 共通関数を呼び出して使う
    total = GetTaxPrice(1000)
    MsgBox "税込価格は " & total & " 円です。"
End Sub

このように、Function（ファンクション）を使って処理を独立させることで、他のマクロからも GetTaxPrice と書くだけで簡単に呼び出せるようになります。これが共通化の第一歩です。

4. クラスモジュールで「モノ」として管理する

「クラスモジュール」は、初心者の方にとって最初の壁に感じられるかもしれません。しかし、考え方はとてもシンプルです。クラスとは、「データ」と「処理」をセットにした「型紙（設計図）」のことです。

例えば、「社員」というクラスを作るとします。社員には「名前」や「社員番号」というデータがあり、「出勤する」という行動（処理）があります。これらをバラバラに管理するのではなく、ひとまとめにして扱うのがクラスの役割です。

以下のコードは、「挨拶をする人」という設計図（クラス）を作り、それを使って実際に挨拶をさせる例です。まずは「Class_Person」という名前でクラスモジュールを作成したと仮定します。


' --- クラスモジュール (名前: Class_Person) の中身 ---
Public Name As String

Public Sub SayHello()
    MsgBox "こんにちは、私は " & Name & " です。"
End Sub

' --- 標準モジュールの実行コード ---
Sub TestClass()
    ' 設計図から「実体」を作る
    Dim worker As New Class_Person
    
    ' データをセットする
    worker.Name = "田中太郎"
    
    ' 処理を実行する
    worker.SayHello
End Sub

クラスを使うことで、プログラムが現実世界の概念に近くなり、管理が非常にしやすくなります。これも立派なプロジェクト構成戦略の一つです。

5. フォルダ分けのようにモジュール名を工夫する

VBAのプロジェクトエクスプローラー（画面左側のツリー表示）では、フォルダを作って細かく分ける機能がありません。そのため、名付けのルール（命名規則）を決めることが、プロジェクト構成において極めて重要です。

例えば、以下のように接頭辞（頭につける文字）を決めておくと、アルファベット順に綺麗に並び、一目で役割がわかります。

モジュール名の例	役割・カテゴリ
`mod_Common`	どのツールでも使う計算などの共通関数
`mod_FileIO`	ファイルの読み込みや保存に関する処理
`cls_Employee`	社員データを扱うためのクラスモジュール
`frm_Main`	ユーザーが操作する入力画面（ユーザーフォーム）

パソコンのデスクトップがアイコンで埋め尽くされていると作業効率が落ちるのと同じで、VBAの世界も名前を整理して「どこに何があるか」を明確にすることが、再利用性を高める鍵となります。

6. エラー処理も共通化してプロジェクトを安定させる

プログラムを作っていると、予想外のトラブル（エラー）が起きることがあります。例えば、「開こうとしたファイルが見つからない」「数字を入れる場所に文字が入っている」といった場合です。これらのエラーへの対策を毎回書くのは大変です。

そこで、エラーが起きたときにメッセージを表示する処理も、共通関数として独立させておきましょう。これにより、プロジェクト全体の品質を一定に保つことができます。


' エラーメッセージを表示する共通サブプロシージャ
Sub ShowErrorMessage(errNum As Long, errDesc As String)
    MsgBox "エラーが発生しました。" & vbCrLf & _
           "番号: " & errNum & vbCrLf & _
           "内容: " & errDesc, vbCritical, "システムエラー"
End Sub

' 実際のツールでの使用例
Sub SampleProcess()
    On Error GoTo ErrorHandler
    
    ' ここで何かエラーが起きる処理（例：0で割り算）
    Dim result As Integer
    result = 10 / 0
    
    Exit Sub

ErrorHandler:
    ' 共通のエラー表示関数を呼び出す
    ShowErrorMessage Err.Number, Err.Description
End Sub

このように、よく使う処理を共通化しておくことで、メインのプログラム（SampleProcess）がスッキリして読みやすくなります。