📤 EXCEL VBA module Sync - VSCode ⇄ Excel

概要（Japanese）

EXCEL VBA module Sync は、開いているExcel の VBA モジュールを VSCode 上で編集するための拡張機能です。
VBA モジュールのVSCodeへのエクスポート、VSCodeで編集した内容のVBAへのインポートが行えます。
Winsdows10/11＋Excel＋VSCode環境でのみ動作します。

• ✅ 開いているExcelブックから .bas / .cls / .frm 内のコードをエクスポート（保存）
• ✅ VSCode 上で編集
• ✅ 編集したモジュールを 開いているExcelブック にインポート（反映）
• ✅ インポートはモジュール差し替えにて行います
• ✅ エクスポートしたモジュールファイルはgitで管理しやすいようにUTF-8の文字コードで出力されます。
• ✅ Excel マクロ実行（モジュール＋プロシージャ、または完全修飾名で実行可能）
• ✅ VBA コード検索（開いている全ブック・全モジュールを対象に、正規表現やフィルタ指定で検索可能）
• ✅ フローチャート作成（右クリックで選択したモジュールのフローチャートを作成）

🔧 主な機能

| 機能 | 説明 | |--------------------------------|-------------------------------------------| | Export All Modules From VBA | 開いているExcel から全モジュールを抽出・保存| | Import Module To VBA | VSCode 上で編集したコードを Excel に反映（単独モジュール/ファイル） | | Set Export Folder | エクスポート先フォルダをダイアログにて選択 | | Excel VBA: List & Run Macro | 開いているブックより指定マクロを実行 | | Excel VBA: Search VBA Code | 開いているブック・モジュール対象にコード検索（正規表現対応） | | Generate VBA Flow Chart | エクスポート先フォルダに mmdフォルダを作成し、マーメイド形式(*.mmd)で簡易フローチャートを出力 （実験的機能）| | コマンドパレット／ボタン対応 | GUI 操作または Ctrl+Shift+P から実行可 |

Overview (English)

EXCEL VBA module Sync is a VSCode extension for editing opened Excel VBA modules.
You can export VBA modules to VS Code and import the content edited in VS Code back into VBA. Works in a Windows 10/11 + Excel + VS Code environment only.

• ✅ Export inner code of .bas / .cls / .frm from opened Excel
• ✅ Edit VBA modules in VSCode
• ✅ Import modules back into opened Excel
• ✅ Import is performed by replacing the module.
• ✅ Exported module files are saved in UTF-8 encoding, making them easier to manage with Git.
• ✅ Execute Excel macros (by module/procedure or fully qualified name)
• ✅ Search VBA code (across all open workbooks/modules, with regex and filters supported)
• ✅ Generate flowchart (Create a flowchart for the module selected with right-click)

🔧 Features

| Feature | Description | |--------------------------------|------------------------------------------------------------------| | Export All Modules From VBA | Extract and save all VBA modules from opened Excel | | Import Module To VBA | Reflect modified code back to opended Excel(Module-based/File-based) | | Set Export Folder | Change export folder via Dialog | | Excel VBA: List & Run Macro | Execute macros by name or fully qualified path in the open workbook| | Excel VBA: Search VBA Code | Search VBA code in the open workbook (with regex support) | | Generate VBA Flow Chart (Experimental) | Create an mmd folder in the export destination and output a simple flowchart in Mermaid format (*.mmd). | | Command Palette / GUI support | Use commands or side panel buttons |

🧩 インストール（VSIX） / Install from VSIX

From Marketplace

1. Visual Studio Marketplace - excel-vba-sync
2. Visual Studio Code を開き、拡張機能ビューからインストール

拡張機能ビューからできない場合は、以下をお試しください。

From Marketplace(Powershell)

以下コマンドを実行

code --install-extension 9kv8xiyi.excel-vba-sync

From Github(VSCode)

1. https://github.com/EitaroSeta/excel-vba-sync/releases/download/latest/extension.vsix よりextension.vsixをダウンロード
2. VS Code を開く
3. 拡張機能ビュー（Ctrl+Shift+X / Cmd+Shift+X）を開く
4. 右上の「…」メニュー → VSIXからのインストール... を選択
5. ダウンロードしたextension.vsix ファイルを選択
6. Reloadを実行

From Github(Powershell)

以下コマンドを実行

$URL = "https://github.com/EitaroSeta/excel-vba-sync/releases/download/latest/extension.vsix"
$OUT = "$env:TEMP\extension.vsix"
curl.exe -sS -L -f --retry 3 --retry-delay 2 "$URL" -o "$OUT"
code --install-extension "$OUT"

⚠重要 / Important

●エクスポートしたファイルの属性は編集しないでください

エクスポートした .frm/.cls/.bas の 属性行は編集しないでください。VERSION、Begin … End、Object = …、および Attribute VB_*（例：VB_Name / VB_PredeclaredId / VB_Exposed / VB_Creatable など）を変更すると、インポート失敗や既存フォームとの紐付け崩れが発生します。

●モジュールの新規追加はできません

既存のモジュール/クラス/フォームを入替えを行う仕組みの為、新規の追加はできません。 VBA上で新規モジュールを追加し、エクスポートしてください。

●EXCELファイルは必ずバックアップしてください

この拡張機能はEXCELファイルを外部から操作する仕組みなので、条件によりEXCELファイルを破損させる恐れがあります。EXCELファイルのバックアップを必ず取ってから連携させて下さい。

●COMエラーについて

Excel に長時間触れずに放置した後や、画面ロック復帰直後などにインポート／エクスポートを実行すると、 次のようなエラーが発生する場合があります。
STDERR: Call was rejected by callee. (HRESULT からの例外:0x80010001 (RPC_E_CALL_REJECTED))
これは Excel 側が一時的に応答できない状態にあるため、COM 呼び出しが失敗して発生するエラーです。
この場合は Excelを再起動すると解消されます。

●Do not edit attributes of exported files

Do not edit the attribute lines in exported .frm/.cls/.bas files. Changing VERSION, Begin … End, Object = …, or any Attribute VB_* (e.g., VB_Name, VB_PredeclaredId, VB_Exposed, VB_Creatable) can cause import failures, and loss of linkage to the original form.

●New modules, classes, or forms cannot be added;

New modules, classes, or forms cannot be added; this tool only replaces existing ones.If you need to create a new item, first add a blank module/class/form in the VBE, then export it.

●Please back up your EXCEL files

This extension operates externally on EXCEL files, so depending on the conditions, there is a risk of corrupting the file. Please make sure to always back up your EXCEL files before linking them with this extension.

●About COM Error

When running import/export operations after leaving Excel idle for a long time or resuming from a screen lock, you may encounter the following error:
STDERR: Call was rejected by callee. (HRESULT 0x80010001)
This occurs because Excel is temporarily unable to respond, causing the COM call to fail.
Restarting Excel will resolve the issue.

🛠 開発者向け情報 / Development (for GitHub users)

このセクションは拡張機能の利用者には不要です。拡張の開発や修正する際の作者の備忘です。
This section is unnecessary for extension users. It serves as a memo for the author when developing or modifying the extension.
https://github.com/EitaroSeta/excel-vba-sync

前提 / Requirements

• Windows10/11 + Microsoft Excel（VBA を実行するため）
• Windows PowerShell 5.1/v2025.2.0（PowerShell 7 は未検証）
• Node.js LTS（18 以上推奨）と npm
• Visual Studio Code（拡張の起動・デバッグに使用）

セットアップ / Setup

npm install

ビルド & 実行 / Build & Run

npm run compile

• VS Code で F5 を押して Extension Development Host を起動

主要コマンド / Key Commands

• Export All Modules From VBA — Excel から VBA モジュールを一括エクスポート
• Import Module To VBA — 編集したモジュールを Excel に取り込み
• Set Export Folder — エクスポート先フォルダの指定

パッケージ化 / Package

• 準備 / Preparation

npm i -g @vscode/vsce  

• 配布 / Publish
  vsce で配布用 .vsix を作成可能（CLI）。

npm run vscode:prepublish    ※npm run compile     
vsce package                 ※extension.vsix 生成  
vsce publish                 ※公開  

.vscodeignore により TypeScript やテスト等はパッケージから除外されます。

リポジトリ構成（抜粋） / Repo Layout

• src/ — 拡張のソースコード（TypeScript）
• scripts/ — Excel 連携用 PowerShell Script
• locales/ — 多言語リソース（ja.json, en.json）

アーキテクチャ変更概要

v.0.0.27の機能追加にて、VS Code (extension.ts) から Node.js サーバ (server.ts) を子プロセスとして起動し、さらに PowerShell スクリプト経由で Excel COM API を操作する流れを追加。

flowchart LR
  EXT["extension.ts(VS Code Extension)"]
  SRV["server.ts   (Node MCP-like server)"]
  PS ["PowerShell Scripts(.ps1)"]
  XLS["Excel COM   (VBA Project/Modules)"]

  EXT -- JSON-RPC (stdio) --> SRV
  SRV -- execFile         --> PS
  PS  -- COM Automation   --> XLS
  PS  -- stdout(JSON)     --> SRV
  SRV -- result           --> EXT

⚙️ ローカライズ設定例 / Localization Example

拡張機能の表示テキストは locales フォルダの言語別 JSON ファイルで管理しています。
現在は以下の2言語に対応していますので、*.jsonを使用したい言語に合わせて作ってください。

The extension’s display text is managed in language-specific JSON files located in the locales folder.
Currently, the following two languages are supported, so please create a *.json file for the language you want to use.

locales/
├─ ja.json
└─ en.json