📤 VBA Module Sync - VSCode ⇄ Excel

概要（Japanese）

VBA Module Sync は、Excel の VBA モジュールを VSCode 上で編集するための拡張機能です。
VBA モジュールのエクスポート・インポートを双方向で行えます。

✅ Excelから .bas / .cls / .frm 内のコードをエクスポート（保存）
✅ VSCode 上で編集
✅ 編集したモジュールを Excel にインポート（反映）
✅ インポートはモジュール差し替えにて行います

🔧 主な機能

機能	説明
Export All Modulus From VBA	Excel から全モジュールを抽出・保存します。
Import Module To VBA	VSCode 上で編集したコードを Excel に反映（単一モジュール単位/ファイル単位）
Set Export Folder	ダイアログ選択可能
コマンドパレット／ボタン対応	GUI 操作または `Ctrl+Shift+P` から実行可

Overview (English)

VBA Module Sync is a VSCode extension for editing Excel VBA modules.
It enables bidirectional sync between Excel and VSCode.

✅ Export inner code of .bas / .cls / .frm from Excel
✅ Edit VBA modules in VSCode
✅ Import modules back into Excel
✅ Import is performed by replacing the module.

🔧 Features

Feature	Description
Export All Modules From VBA	Extract and save all VBA modules from Excel
Import Module To VBA	Reflect modified code back to Excel(Module-based/File-based)
Set Export Folder	Change export folder via Dialog
Command Palette / GUI support	Use commands or side panel buttons

⚠重要 / Important

エクスポートした .frm の属性は編集しないでください

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

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

既存のモジュール/クラス/フォームを入替えを行う仕組みの為、新規の追加はできません。新規に作成する場合は空のモジュールを追加・保存したうえでエクスポートしてください。

Do not edit attributes of exported .frm files

Do not edit the attribute lines in exported .frm (UserForm) files. Changing VERSION, Begin … End, Object = …, or any Attribute VB_* (e.g., VB_Name, VB_PredeclaredId, VB_Exposed, VB_Creatable) can cause re-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 and save a blank module/class/form in the VBE, then export it.

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

このセクションは拡張機能の利用者には不要です。拡張の開発や修正向けの備忘です。

前提 / 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

vsce で配布用 .vsix を作成できます（CLI）。

npm i -g @vscode/vsce  
vsce package

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

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

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

⚙️ ローカライズ設定例 / 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

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

From VS Code UI(VSIX)

VS Code を開く
拡張機能ビュー（Ctrl+Shift+X / Cmd+Shift+X）を開く
右上の「…」メニュー → VSIXからのインストール... を選択
作成した .vsix ファイル（例: extension.vsix）を選択
Reloadを実行

From Powershell(VSIX)

以下コマンドを実行

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

From Marketplace

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

excel-vba-sync

Seta Engineering