
エクスポートしたVBAの日本語が文字化けする本当の理由——.basファイルはShift-JISで保存する
VBE(Visual Basic Editor。ExcelでAlt+F11を押すと開くマクロの編集画面です)では、モジュールを右クリックして「ファイルのエクスポート」を選ぶと、VBAのソースを.basというテキストファイルとして取り出せます。
取り出した.basファイルをVS Codeで開いて手直しする。保存して、VBEにインポートし直す。——それだけの操作のはずが、モジュールを開いた画面に並んでいたのは「譁・ュ怜喧」のような記号の羅列でした。
日本語のコメントも、プロシージャ名も、全部読めない。正直、血の気が引きました。「ファイルが壊れた」と思ったからです。私は本業で数十本のExcelマクロを自作して管理していて、コードをファイルに出して管理し始めた初期に、まさにこの画面を見ました。
でも実は、これはファイルの破損ではありません。文字化けの原因は文字コードの食い違いで、少しの設定と約束事で防げます。結論を先に言うと、.basはUTF-8ではなくShift-JIS(CP932)で保存する。この記事では、そうなる理由からVS CodeとPythonでの具体的な設定、ハマりやすい落とし穴まで順番にまとめます。なお、本記事はWindows版Excelの話です(Mac版は事情が異なります)。
なぜUTF-8だと文字化けするのか——VBEは今もShift-JIS(CP932)で読み書きする
まず前提から。コンピュータは文字をそのままファイルに保存できず、数値(バイト列)に置き換えて保存し、読むときに数値から文字へ引き直します。この「文字と数値の対応表」が文字コードです。同じ「あ」でも、Shift-JISでは2バイト、UTF-8では3バイトの別の数値になります。だから、書く側と読む側で同じ表を使う約束が必要なのです。
今回の登場人物は2つ。ひとつめのVBEは、.bas(標準モジュール)、.cls(クラスモジュール)、.frm(フォーム)の読み書きを「ANSI」で行います。ANSIはWindowsが言語版ごとに定める既定の文字コードで、日本語版Windowsの既定はShift-JIS(CP932)。CP932はShift-JISをWindows向けに少し拡張したもので、この記事では同じものとして扱います。
そしてVBEは、UTF-8を正しく読む機能を持っていません。もうひとつは今どきのエディタ。VS Codeをはじめ、最近のエディタの既定の保存形式はUTF-8です。ここで約束がズレます。
VBEがエクスポートした.basは、Shift-JISで書かれている
エディタで編集して保存すると、UTF-8に変換されることがある
UTF-8になったファイルを、VBEはShift-JISのつもりで読む
バイト列の解釈がズレて「譁・ュ怜喧」になる

つまり「化けた=壊れた」ではなく、あの記号の羅列は「別の表で引かれてしまった、元のままのデータ」なのです。化けて見えるファイルも、実際に書かれている方の文字コードで開き直せば読めることがほとんどです(ただし、化けた表示のまま上書き保存してしまった場合は、元のデータ自体が書き換わっているため、開き直しでは戻りません)。VS Codeなら右下の表示から「エンコード付きで再度開く」——エクスポート直後の.basならShift-JIS、エディタでUTF-8保存した後ならUTF-8です。
仮に崩してしまっていても、エクスポート元のブックにコードはそのまま残っています。まずは安心してください。
VBEの基本設計は1990年代のもの。当時のWindowsアプリはANSIで読み書きするのが標準で、VBAは「昔のマクロが今のExcelでも動く」互換性を何より大切にしてきたため、出入り口も当時のままなのです。
面白いのは、VBAの内部——実行時の文字列処理——はUnicodeで動いている点。ANSIなのはソースファイルの読み書きだけで、そこさえ合わせれば、VBAのソースはブックの外で自由に編集できるわけです。
化けないための文字コード設定手順——VS CodeとPython
方針はシンプルです。VBEはUTF-8を読めないのだから、ファイルの側をShift-JISにそろえる。管理者権限は不要で、手順は3つ。最後におまけの補足をひとつ添えます。
1. VS Code:フォルダ単位でShift-JIS保存にする
VS Codeには、フォルダごとに設定を上書きする「ワークスペース設定」があります。VBAソースを置くフォルダ直下に.vscode/settings.jsonを作り、こう書きます。
{
// このフォルダのファイルをShift-JIS(CP932)で開き、保存する
"files.encoding": "shiftjis",
// 改行はWindows標準のCRLFにそろえる
"files.eol": "\r\n"
}これで、このフォルダのファイルはShift-JISで開かれ、Shift-JISで保存されます。フォルダ単位で効くので、ほかのプロジェクトはUTF-8のまま。なお、この設定が効くのはVS Codeでこのフォルダごと開いたとき(メニューの「ファイル」→「フォルダーを開く」)です。ファイルを単体で開くと適用されません。右下の表示が「Shift JIS」になっていれば成功です。
すでにUTF-8で保存してしまったファイルは、この設定を入れると逆に化けて見えます。「エンコード付きで再度開く」でUTF-8を選んで表示を直し、「エンコード付きで保存」でShift-JISを選べば、以後は化けずに往復できます。
2. Python:encoding="cp932"を指定して書き出す
プログラムで.basを生成・加工する場合は、書き出すときに文字コードを明示します。
code = """Attribute VB_Name = "Sample"
Sub Hello()
MsgBox "こんにちは" ' 日本語コメントもOK
End Sub
"""
# cp932=Shift-JIS。newline="\r\n"で改行もWindows標準になる
with open("Sample.bas", "w", encoding="cp932", newline="\r\n") as f:
f.write(code)ポイントはencoding="cp932"とnewline="\r\n"の2か所だけ。この形で書き出したファイルは、VBEにそのままインポートしても化けません。なお、同名モジュールが残ったままだと末尾に数字付きの別名で取り込まれるので、入れ替えは先に既存モジュールを解放(削除)してから(差し替えの自動化は別の記事で詳しく解説しています)。
https://note.com/tegumi/n/nf9289722a85f
3. 落とし穴:CRLF・CP932にない文字・BOM
細かいつまずきどころが3つあります。
改行コードはWindows標準のCRLFにそろえる。Git(変更の履歴が全部残る仕組み)やエディタの設定でLFに変換されることがあるため、手順1と2の指定で固定しておくと安心です。なお、files.eolが決めるのは新しく作るファイルの改行なので、すでにLFになってしまったファイルは、右下のCRLF/LF表示をクリックしてCRLFに戻してから保存してください
CP932にない文字——絵文字や一部の記号・旧字——は、コメントにも使わない。保存時にエラーになるか(PythonならUnicodeEncodeError)、別の文字に置き換わります。生成AIのコメントには絵文字が混ざりがちなので、保存前にひと目確認を
BOM付きUTF-8も不可。BOMはファイル先頭に付く「これはUTF-8です」という目印ですが、VBEは解釈できません。迷わずShift-JIS一択が早道です
なお、Windowsの言語設定でUTF-8を既定にする「ベータ」設定を有効にした環境では、ANSI自体がUTF-8になり話が変わります。心当たりがなければ既定のままです。

4. おまけ:.clsと.frmは少しだけ特別
標準モジュール(.bas)は中身がほぼコードだけですが、クラスモジュール(.cls)には「VERSION 1.0 CLASS」で始まる数行のヘッダが必要です。手で書くと間違えやすいので、VBEからエクスポートしたファイルを雛形に取っておき、中身だけ書き換えるのが安全です。
また、フォーム(.frm)は同名の.frx(ボタン配置などのバイナリ)とペアです。テキストとして編集できるのは.frm側だけで、インポート時は同じフォルダに.frxが必要。常にセットで扱ってください。
さて、ここまでが対処法です。ただ、この一件でいちばん大きかったのは「約束さえ守れば、VBAのソースはただのテキストとして扱える」という気づきでした。
ただのテキストになれば、できることが一気に広がります。使い慣れたエディタで横断検索・置換できる。修正前後の差分が取れる。Gitに入れれば変更の履歴が全部残る。AIに読ませて解説や修正案をもらえる。ブックに閉じ込められていたコードが、便利な道具をぜんぶ使えるようになる——文字化けの対処は、じつはその入り口だったわけです。

それでも難しいときは
「化けたファイルを上書きしてしまった」「マクロが何十本もあってテキスト化の作業量が読めない」——そんな状況もあると思います。
化けたファイルも、バイト列が残っていれば復元できるケースは少なくありません。ブックの棚卸しからテキスト化・整理までは、手順さえ決めれば淡々と進められる作業です。私はTegumiという屋号で、VBAの解読・修正やPythonによる業務自動化を個人でお受けしています。「自分でやる時間が取れない」ときは、選択肢のひとつとして思い出していただければうれしいです。
おわりに
「譁・ュ怜喧」という文字化けの正体は、故障でも呪いでもなく、対応表のズレでした。VBEはShift-JIS(CP932)、今どきのエディタはUTF-8。この食い違いさえ押さえて、フォルダ単位の設定と少しの約束を守れば、.basはもう化けません。
そして化けなくなった.basは、好きな道具で扱える「ただのテキスト」です。テキスト化したコードをブックの外の1か所に集めて管理する話——その集約先のフォルダを、私は「マクロの保管庫」と呼んでいます——は、別のシリーズで仕組みごと紹介しています。エクスポートのその先が気になった方は、そちらもどうぞ。
https://note.com/tegumi/n/n57214a632f92
VBAやPythonの自動化のご相談はこちらからどうぞ。
https://tegumi.dev/