【VBA】コメントアウトを設定する方法

【VBA】コメントアウトを設定する方法

公開: 更新:
CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

VBAで処理の意図をメモしたり、一時的にプログラムを無効化したりする場面は、マクロの機能追加やエラーの修正作業などで頻繁に発生します。コードをわかりやすく整理する手段としてよく使われるのが「コメントアウト」機能で、スムーズなデバッグやチーム内での仕様共有を実現できます。

この記事では、VBAのコメントアウトの基本的な使い方について、詳しく解説していく流れです。複数行を一括で処理するコメントブロックの活用法やアクセスキー(キーボード操作の補助機能)の設定手順など、サンプルコード付きで紹介しますので、ぜひ参考にしてください。



VBAでコードをコメントアウトする方法

VBAでコードにコメントを追加する方法は、大きく分けて以下の3つがあります。

  1. シングルクォーテーションで1行をコメントアウトする
  2. コメントブロックで複数行を一括設定する
  3. ユーザー設定でショートカット(アクセスキー)を割り当てる

それぞれ操作の粒度や使用場面が異なるため、目的に合わせた使い分けが効率的です。それでは各項目について、詳しく解説していきます。

シングルクォーテーションで1行をコメントアウトする

VBAで特定の1行をコメントとして扱うには、行頭やコードの途中に「'(シングルクォーテーション)」を入力する仕様です。デフォルト設定では入力した文字以降が緑色に変わり、プログラムの実行時には無視されるため、処理内容のメモ書きとして活用できます。

以下のコードは、セルに値を入力する処理に対して、シングルクォーテーションでコメントを追加する例です。

Sub SampleComment()
    ' A1セルにテストと入力する
    Range("A1").Value = "テスト"

    Range("B1").Value = "テスト" ' ここにもコメントを記述可能
End Sub

上記のコードでは、行の先頭とコードの末尾にそれぞれメモを追加しています。コメント化された部分はマクロの動作に一切影響を与えません。

なお、VBA特有の文法ルールとして、行連結文字(_)を含む行では行末コメントが書けないため、コメントは別の行として独立して記述する必要があります。長いコードを改行して記述する際は、行連結の前後にはコメントを置かず、独立したコメント行を別途追加する形で対応してください。


Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

コメントブロックで複数行を一括設定する

初期状態の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のコメントアウトに関するよくある質問


Python基礎・実践(Django)

企業・法人向けのPython研修では、基礎から応用まで体系的に学べます。

Python研修の詳細

DX社員研修

企業・法人向けのDX研修では、実務に繋がるリスキリングでITレベルを向上させます。

DX研修の詳細

Javaエンジニア育成研修

企業・法人向けのJavaエンジニア育成研修では、Javaの基礎から応用まで確実に習得できます。

Java研修の詳細

新卒・新入社員向け研修

企業・法人に新入社員・新卒社員に向けたプログラミング研修を提供しています。

新入社員研修の詳細

コードキャンプのIT研修を全て見る

日本語コメントが文字化けする場合の対処法はありますか?

VBEで日本語を入力した際に、文字化けが発生する場合はフォント設定の変更が最も有効です。Microsoft Learnでは、次のような確認手順が案内されています。

[ツール] -> [オプション]を開き、 [エディターの設定]タブ上の[フォント名]を 確認されることをお奨めします。

出典:Microsoft Learn Excel VBE にて、日本語入力が文字化けする

MS ゴシックなどの日本語対応フォントを選択し直すことによって、多くのケースで解決します。フォント変更で改善しない場合は、Windowsの「地域の設定」でロケールも確認してください。

VBAでコメントを残すべき具体的なケースを教えてください

VBAでコメントを残す主な目的は、コードが「なぜそのような処理を行っているのか」という意図を明確にすることです。単なる動作の説明ではなく、複雑なロジックの背景や前提条件を書き残しておく手法が推奨されています。

また、プログラムの挙動をテストする際に、特定の行を一時的に無効化するデバッグ目的でも頻繁に利用します。未来の自分や他のチームメンバーがコードを保守しやすくするための工夫と言えます。

昔の記述であるRemを使ってコメントアウトしてもよいですか?

Remを用いたコメントアウトは現在も公式仕様として有効ですが、行末コメントにコロン(:)での区切りが必要になるなど記述の手間が増えるため、現在はシングルクォーテーションを使うのが主流です。特別な理由がなければシングルクォーテーションを選び、コード全体でコメントの書き方を統一しておくとメンテナンスが楽です。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。

ITやプログラミングに関するコラム


    ITやプログラミングに関するニュース

      ブログに戻る

      コメントを残す

      コメントは公開前に承認される必要があることにご注意ください。

      企業・法人向けのIT・プログラミング・生成AI研修を探す、比較する - IT・プログラミングを知って学べるコネクトメディア CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座 - IT・プログラミングを知って学べるコネクトメディア コードキャンプが提供する無料で学べるプログラミングスクール講座 - IT・プログラミングを知って学べるコネクトメディア コードキャンプDX人材育成研修 - IT・プログラミングを知って学べるコネクトメディア 3.5日の研修で、年間1,600時間の削減効果が見込まれる。東京きらぼしフィナンシャルグループのDX人材育成事例 - IT・プログラミングを知って学べるコネクトメディア 配属3ヶ月で30%の生産性向上を実現するいよぎんコンピュータサービスの新人研修に迫る - IT・プログラミングを知って学べるコネクトメディア 金融業界の業務効率化を加速するニッセイアセットマネジメントの生成AI×GAS活用研修事例 - IT・プログラミングを知って学べるコネクトメディア 【製造業のDX人材育成事例】デジタル人材の即戦力化を実現する、日本ガイシ株式会社の異動者向オンボーディング研修 - ITやプログラミングを知って学べるコネクトメディア フューチャーアーキテクト株式会社が実現した新入社員向けIT研修プログラムでタスクフォース制度が主体的な学びと成長を生み出す - IT・プログラミングを知って学べるコネクトメディア コードキャンプDX人材育成研修 - IT・プログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/【IT新入社員研修】オンラインとオフラインの最適バランスを実現したFutureOneの導入事例 - IT・プログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/【新入社員研修】柔軟なハイブリッド型Java研修で実現した新卒20名の成長と成果|サークレイス株式会社 - ITやプログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/現場により近いところにデジタルを根付かせるDX基礎講座研修|株式会社ブリヂストン - ITやプログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/業務の効率化・DX推進に向けたIT人材育成への第一歩|株式会社カナエ - ITやプログラミングを知って学べるコネクトメディア 企業・法人向けのIT・プログラミング研修 - ITやプログラミングを知って学べるコネクトメディア

      新着記事

      対象者別で探す

      子供(小学生・中学生・高校生)向け
      プログラミング教室検索する

      子供(小学生・中学生・高校生)がロボットやプログラミング言語を学ぶことができるオフラインからオンラインスクールを検索、比較することが可能です。

      子供(小学生・中学生・高校生)
      プログラミング教室検索する

      ITやプログラムなどの
      最新情報を検索する

      日々、新しいITやプログラミング言語の情報が流れていきますが、特定の情報を時系列でニュースやコラムを確認することができます。

      ITやプログラムなどの
      最新情報を検索する