メインコンテンツへスキップ
見出し画像

VBEを開かずにExcelマクロを更新する——PythonでVBAモジュールを差し替える方法

    「先週直してもらった不具合、また出ているみたいです」——ある朝そんな連絡を受け取って、一瞬、頭が真っ白になったことがあります。

    私は本業で、数十本のExcelマクロを自作して管理しています。あるとき共通処理の修正を、同じモジュールを使っている十数冊のブックへ配ることになりました。やり方は昔ながらの手作業。ブックを開き、VBE(Visual Basic Editor。マクロのコード編集画面)を立ち上げて、「モジュールの解放」→「ファイルのインポート」。1冊あたり1〜2分の操作を、ブックの数だけ繰り返します。

    数日後、1冊だけインポートを忘れて古い版のまま残っていたことが判明しました。冒頭の連絡はそのブックのことです。丁寧にやったつもりでも、同じ操作を何十回も繰り返せばどこかで抜けるのだと痛感しました。

    実は、この一連の操作はPythonから自動化できます。VBAのソースコードはテキストとして出し入れできるので、「古いモジュールを外して新しいファイルを取り込む」操作を、まるごとプログラムに任せられます。この記事では、Python+pywin32でExcelブックのVBAモジュールを差し替える手順を、コピペでおおむね動く最小コードつきでご紹介します。

    画像
    手作業のインポートは冊数ぶん繰り返し。Pythonなら何冊あっても実行1回です

    なぜPythonからExcelのマクロを触れるのか

    土台は、COM(Component Object Model。Windowsのアプリを外から操作するための共通の窓口)という仕組みです。Excelはこの窓口から「ブックを開く」「セルに書き込む」といった機能を外部に公開していて、VBAプロジェクトの操作もそのひとつです。

    VBEで右クリックして行う「解放」や「インポート」は、内部的にはVBProjectというオブジェクトへの命令。マウスで操作してもプログラムから命令しても、通る道は同じなのです。pywin32は、このCOMをPythonから呼び出す定番ライブラリです。

    つまりVBEでの手作業は、「Excelの仕様上そうするしかない」のではなく、単にまだ自動化していないだけ。ここが今回の出発点です。

    PythonでVBAモジュールを差し替える手順

    1. 前提条件をそろえる

    必要なものは3つです。

    • Windows+デスクトップ版Excel:COMを使うため、MacやWeb版のExcelでは動きません。

    • Python+pywin32:コマンドプロンプトで pip install pywin32 を実行しておきます(パッケージ名はpywin32ですが、コード内では win32com として読み込みます。shutilはPython標準ライブラリなので追加インストールは不要です)。

    • Excel側の設定をひとつ:ファイル→オプション→トラストセンター(以前のバージョンでは「セキュリティ センター」)→トラストセンターの設定→マクロの設定と進み、「VBAプロジェクト オブジェクト モデルへのアクセスを信頼する」にチェックを入れます。チェックがないとVBProjectへアクセスした時点でエラーになります。

    既定でオフなのは、この窓口を悪用したマクロウイルスがあった歴史への備え。差し替え作業を行う端末でだけオンにするのがおすすめです。

    2. 「新しいExcelプロセス・マクロ無効」で開く

    コードの前に、安全に動かすためのポイントを2つ。

    まず、Excelの起動には DispatchEx を使います。よく紹介される Dispatch は、開いているExcelがあればそれを掴んでしまい、作業中のブックと自動処理が混ざる事故や不可解なCOMエラーの原因になります。DispatchEx なら必ず新しいプロセスが立ち上がり、手元の作業と完全に切り離せます。

    次に AutomationSecurity = 3。これは「マクロを無効にしてブックを開く」設定で、Workbook_Openのような自動実行マクロが発火しなくなります。あわせて Visible = False で画面を出さず、DisplayAlerts = False で確認ダイアログも抑えます。

    3. 最小コードで差し替える——本体はVBComponentsのRemove→Importの2段

    標準モジュール「集計モジュール」を新しい版に差し替える、最小構成のコードです。取り込む.basファイルはShift-JIS(CP932)で保存しておきます(詳しい理由は後述します)。

    import shutil, win32com.client
    book = r"C:\work\サンプル.xlsm"  # 差し替え対象のブック
    shutil.copy2(book, book + ".bak")                        # 1. まずバックアップ
    excel = win32com.client.DispatchEx("Excel.Application")  # 2. 新しいExcelプロセス
    excel.AutomationSecurity = 3                             # 3. マクロは無効で開く
    excel.Visible = False                                    #    画面は出さない
    excel.DisplayAlerts = False                              #    確認ダイアログも抑止
    try:
        wb = excel.Workbooks.Open(book)
        comps = wb.VBProject.VBComponents                    # 4. モジュールの一覧
        comps.Remove(comps("集計モジュール"))                  # 5. 古い版を解放
        comps.Import(r"C:\work\集計モジュール.bas")            # 6. 新しい版を取り込む
        wb.Save()                                            # 7. うまくいったら保存
    finally:
        excel.Quit()                                         # 8. 必ずExcelを終了

    wb.VBProject.VBComponents は、標準モジュールやクラス、フォームからSheet1・ThisWorkbookまで含む、ブック内の全モジュールの一覧です。差し替えの本体は「Remove(解放)→Import(取り込み)」の2段だけ。VBEでの手作業と、やっていることは同じです。なお、ユーザーフォーム(.frm)は、対のバイナリファイル(.frx)を同じフォルダに置いておけばImport時に自動で読み込まれます。

    安全面も見ておきます。書き換える前に shutil.copy2 でバックアップを取り、途中でエラーが起きた場合は wb.Save() に到達しないままfinallyへ抜けてExcelが終了するため、元のブックには変更が残りません。「成功したときだけ保存される」構成です。

    画像
    差し替えの流れ。バックアップとfinallyのQuitが安全網になります

    4. シートモジュールとThisWorkbookは「中身だけ」入れ替える

    ひとつだけ、Remove→Importが通用しない相手がいます。Sheet1などのシートモジュールと、ThisWorkbookです。これらは「Document型」という特別なモジュールで、シートやブックそのものと結びついているため、Removeで外せません。いわば、あとから差し込むカートリッジではなく、本体に組み付けられた基板です。

    その場合は、器は残して中身だけを入れ替えます。CodeModule(コード本文を扱うオブジェクト)の DeleteLines で全行を消し、AddFromString で新しいコードを書き込みます。次のコードは、サンプル1のtryブロック内(wbを開いたあと・wb.Save() の前)で使う断片です。

    cm = wb.VBProject.VBComponents("Sheet1").CodeModule
    if cm.CountOfLines > 0:
        cm.DeleteLines(1, cm.CountOfLines)   # 中身だけ全部消す(器は残る)
    with open(r"C:\work\Sheet1のコード.txt", encoding="cp932") as f:
        cm.AddFromString(f.read())           # 新しいコードを流し込む

    ここで指定する "Sheet1" はシート見出し(タブ名)ではなく、VBEのプロジェクトウィンドウに出るオブジェクト名です(見出しを変えてもこちらは変わりません)。実行後はVBEで中身が置き換わったことを確かめてみてください。

    画像
    標準モジュールは丸ごと交換、シートモジュールとThisWorkbookは中身だけ交換

    5. 落とし穴と、最初の一歩

    試すときの注意点を3つ、運用に載せるときの弱点を2つ、最後に最初の一歩をひとつ。

    まず文字コード。取り込む.basファイルはUTF-8ではなくShift-JIS(CP932)で用意します。この罠は根が深いテーマなので、別の記事で詳しく解説しています。

    https://note.com/tegumi/n/n7ddeb5bc62d5

    次に、パスワード保護のかかったVBAプロジェクトは、先にVBEでロックの解除を。保護されたままではVBComponentsへのアクセスがエラーになります。

    そして、いきなり本番のブックで試さないこと。コピーとモジュール1本で確かめてから対象を広げるのが安心です。

    運用に載せるときの弱点も、正直に書いておきます。1つ目はパス。ブックの場所や名前をプログラムや説明書きに書いて運用することになるため、この仕組みはファイルの引っ越しやリネームに弱いのです。パスは設定として1箇所にまとめておき、「ブックを動かしたら必ずそこも直す」を先に約束ごとにしておくと消耗しません。

    2つ目は共有ブックならではの事情。誰かがブックを開いていると保存に失敗するので、反映は開かれていない時間帯に行います。また、Excel側でコードを直接直す人がいると手元のソースとズレて、次の反映でその修正が上書きで消えます。「直すときは必ずソース側から」の徹底とセットで運用してください。

    最後に、実は逆方向もできます。VBComponent.Export(パス) で、モジュールをテキストファイルに書き出せます。取り出すだけなら ReadOnly=True で開くとさらに安全。書き出したファイルの先頭には管理用のヘッダーが付き、.basのモジュール名はその中の Attribute VB_Name 行で決まります。シートモジュールの書き出しではこのヘッダーが複数行(VERSION で始まるブロックと Attribute で始まる行)になるため、AddFromStringに使うときはそれらをすべて除いてから流し込みます。

    最初の一歩は、手持ちのブックのコードをExportしてそろえるところから。差し替えの材料にも、そのままバックアップにもなります。

    私はこの方法を本業の数十本のマクロ運用に組み込んでいます。Exportで集めたコードをブックの外のフォルダ——私は「マクロの保管庫」と呼んでいます——にまとめてGit(変更の履歴が全部残る仕組み)で管理し、保管庫から各ブックへ配る処理を「反映プログラム」として1本にまとめる形です。

    この仕組みに切り替えてから、冒頭のような配り漏れは起きていません。モジュールの配布が「気を張る作業」から「実行するだけ」に変わったのが、いちばんの収穫でした。

    それでも難しいときは

    差し替えのコード自体はご覧のとおりシンプルです。ただ実際の運用に組み込むと、「どのブックにどのモジュールが入っているかの棚卸し」「複数ブックへの一括反映をどう回すか」「そもそも今あるマクロの解読から始めたい」など、記事1本では書ききれない論点が出てきます。

    私は副業のTegumi(テグミ)として、こうしたVBA×Pythonの運用自動化の仕組みづくりや、既存マクロの解読・修正のお手伝いをしています。「うちの場合はどう組めばいい?」という段階のご相談でも、環境と運用の実情に合わせて一緒に考えます。

    おわりに

    VBEを開いて、1冊ずつ解放とインポートをくり返す——あの作業は、Pythonとpywin32があれば実行1回に置き換えられます。特別な魔法ではなく、Excelがもともと持っている窓口を外から呼んでいるだけ。まずはコピーしたブック1冊、モジュール1本の差し替えから試してみてください。手順が「毎回同じ」になった瞬間の安心感は、想像より大きいはずです。

    ▶ VBA×Pythonの自動化・マクロの解読・修正のご相談は Tegumi へ

    https://tegumi.dev/

     
     

    Tegumi

     
     
    動かなくなったExcelマクロ(VBA)の解読・修正・引き継ぎと、Pythonでの業務自動化を個人でお受けします。「私のPCだけ動かない」「集計を自動化したい」など、コードを読んで直すのが得意。お見積り無料です → https://tegumi.dev/

    あなたへのおすすめ