VBAで処理の意図をメモしたり、一時的にプログラムを無効化したりする場面は、マクロの機能追加やエラーの修正作業などで頻繁に発生します。コードをわかりやすく整理する手段としてよく使われるのが「コメントアウト」機能で、スムーズなデバッグやチーム内での仕様共有を実現できます。
この記事では、VBAのコメントアウトの基本的な使い方について、詳しく解説していく流れです。複数行を一括で処理するコメントブロックの活用法やアクセスキー(キーボード操作の補助機能)の設定手順など、サンプルコード付きで紹介しますので、ぜひ参考にしてください。
VBAでコードをコメントアウトする方法
VBAでコードにコメントを追加する方法は、大きく分けて以下の3つがあります。
- シングルクォーテーションで1行をコメントアウトする
- コメントブロックで複数行を一括設定する
- ユーザー設定でショートカット(アクセスキー)を割り当てる
それぞれ操作の粒度や使用場面が異なるため、目的に合わせた使い分けが効率的です。それでは各項目について、詳しく解説していきます。
シングルクォーテーションで1行をコメントアウトする
VBAで特定の1行をコメントとして扱うには、行頭やコードの途中に「'(シングルクォーテーション)」を入力する仕様です。デフォルト設定では入力した文字以降が緑色に変わり、プログラムの実行時には無視されるため、処理内容のメモ書きとして活用できます。
以下のコードは、セルに値を入力する処理に対して、シングルクォーテーションでコメントを追加する例です。
Sub SampleComment()
' A1セルにテストと入力する
Range("A1").Value = "テスト"
Range("B1").Value = "テスト" ' ここにもコメントを記述可能
End Sub
上記のコードでは、行の先頭とコードの末尾にそれぞれメモを追加しています。コメント化された部分はマクロの動作に一切影響を与えません。
なお、VBA特有の文法ルールとして、行連結文字(_)を含む行では行末コメントが書けないため、コメントは別の行として独立して記述する必要があります。長いコードを改行して記述する際は、行連結の前後にはコメントを置かず、独立したコメント行を別途追加する形で対応してください。
コメントブロックで複数行を一括設定する
初期状態のVBE(Visual Basic Editor)では編集ツールバーが表示されていないため、まずメニューの「表示」から「ツールバー」を選択し、「編集」にチェックを入れて表示させておく必要があります。ツールバーを表示した後は、「コメントブロック」ボタンを使って複数行を一括でコメントアウトできます。
このボタンは言語仕様の構文ではなく、VBEのエディタが提供するUI機能です。各行の先頭に手作業で記号を打ち込む手間を省き、広範囲のコードを一瞬で無効化できるため、デバッグ作業の効率が向上します。
なお、VBA自体には他言語の/* */のようなブロックコメント構文は存在せず、このボタンは内部的に選択した各行の行頭へシングルクォーテーション(')を一括で付与する仕組みです。複数行のコードを一括でコメントアウトする使い方は、以下の通りです。
Sub SampleBlockComment()
' 以下の3行をまとめて選択し、コメントブロック機能を使います
' Range("A1").Value = 100
' Range("A2").Value = 200
' Range("A3").Value = 300
End Sub
上記のコードでは、セルへ数値を入力する3つの行全体をコメントブロック機能で無効化しています。機能を解除する際は、同じくツールバーにある「非コメントブロック」ボタンをクリックすることによって、各行の行頭シングルクォーテーションが一括削除されます。
ユーザー設定でショートカット(アクセスキー)を割り当てる
VBEの標準機能では、コメントブロックに対する一般的なCtrlキーを使ったショートカットキーは用意されていません。
ただし、ツールバーのユーザー設定でボタン名にアクセスキー(メニュー操作の補助機能)を指定することによって、Altキーと組み合わせたキーボード操作でコメントアウトを実行できます。一般的なショートカットとは仕組みが異なる点に注意してください。
設定の流れは、「表示」→「ツールバー」→「カスタマイズ」を開き、「コメントブロック」コマンドの名前欄に「(&/)」のようにアクセスキーを付与します。設定後は、対象の行を選択した状態でAltキーと指定したキーを順番に押すだけで操作が可能です。
なお、VBEやOfficeのバージョンによってメニュー構成が異なる場合があるため、使用中の環境に応じてカスタマイズ画面の場所を確認してください。
Sub SampleShortcut()
MsgBox "コメントアウトのアクセスキーを設定すると"
' MsgBox "これらの行を瞬時にコメントアウトできます"
End Sub
上記は、アクセスキーを使ってMsgBoxの行をコメントアウトした状態のサンプルです。コメントブロックに「(&/)」、非コメントブロックに「(&\)」のようなアクセスキーを割り当てる方法が一例として知られていますが、特定のキーを公式が推奨しているわけではないため、ご自身の使いやすいキーを任意に設定してください。
アクセスキーの登録は一度行えば維持されるため、VBEをよく使う方は早めに設定しておくとコーディングのスピードが改善されます。
VBAのコメントアウトに関するよくある質問
日本語コメントが文字化けする場合の対処法はありますか?
VBEで日本語を入力した際に、文字化けが発生する場合はフォント設定の変更が最も有効です。Microsoft Learnでは、次のような確認手順が案内されています。
[ツール] -> [オプション]を開き、 [エディターの設定]タブ上の[フォント名]を 確認されることをお奨めします。
出典:Microsoft Learn Excel VBE にて、日本語入力が文字化けする
MS ゴシックなどの日本語対応フォントを選択し直すことによって、多くのケースで解決します。フォント変更で改善しない場合は、Windowsの「地域の設定」でロケールも確認してください。
VBAでコメントを残すべき具体的なケースを教えてください
VBAでコメントを残す主な目的は、コードが「なぜそのような処理を行っているのか」という意図を明確にすることです。単なる動作の説明ではなく、複雑なロジックの背景や前提条件を書き残しておく手法が推奨されています。
また、プログラムの挙動をテストする際に、特定の行を一時的に無効化するデバッグ目的でも頻繁に利用します。未来の自分や他のチームメンバーがコードを保守しやすくするための工夫と言えます。
昔の記述であるRemを使ってコメントアウトしてもよいですか?
Remを用いたコメントアウトは現在も公式仕様として有効ですが、行末コメントにコロン(:)での区切りが必要になるなど記述の手間が増えるため、現在はシングルクォーテーションを使うのが主流です。特別な理由がなければシングルクォーテーションを選び、コード全体でコメントの書き方を統一しておくとメンテナンスが楽です。
※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。
