Categories: excel

VBAのコメントアウト完全ガイド|初心者でもすぐに使える基本と応用テクニック

VBA(Visual Basic for Applications)はExcelなどのOfficeアプリケーションを操作するための強力なツールです。
プログラミングを始めたばかりの方でも、VBAを使えば作業を自動化でき、業務の効率がぐっとアップします。
そんなVBAでプログラムを書くときに欠かせないのが「コメントアウト」の使い方です。

コメントは、コードの説明を書いたり、後で修正したい箇所を残したり、エラーを避けるために一時的にコードを無効にするために使われます。
本記事では、VBAにおけるコメントアウトの基本から、複数行のコメントの方法、ショートカットや効率的な記述方法まで丁寧に解説していきます。
初心者の方も安心して学べるよう、画像を使わずともわかる言葉で解説していきますので、ぜひ最後までご覧ください。


コメントアウトとは?

コメントアウトとは、コードの中で処理されない行や文を指定することを言います。
プログラミングでは、説明やメモを残すためにコメントを使います。VBAでは「シングルクォーテーション(’)」を使ってコメントを記述します。

たとえば、以下のように書きます。

'これはコメントです
MsgBox "こんにちは"

この例では、1行目の「これはコメントです」は無視され、2行目のメッセージボックスが表示されます。
コメントはコードの途中にも書くことができます。

MsgBox "こんにちは" 'ユーザーに挨拶を表示

このように、実際の処理には影響を与えず、コードの意味や使い方を補足できます。


VBAでコメントアウトする基本的な方法

VBAでは、コメントアウトするには行の先頭に '(シングルクォーテーション)を付けるだけです。

例:

' ここはコメントです
Dim message As String
message = "こんにちは"
' MsgBox message

上記のように、処理を一時的に無効化したいときや、テスト的にコードを止めたいときなどにコメントアウトが便利です。


コメントアウトを使う3つの主な場面

1. コードの説明や意図を記録

複雑な処理や他人が読むことを想定したコードには、コメントをつけておくと理解が深まります。

' ユーザー名を入力させる
Dim userName As String
userName = InputBox("お名前を入力してください")

2. デバッグや一時的な無効化

問題の箇所を切り分けるために、処理を無効化したいときに使います。

' ここはバグの原因になっている可能性あり
' MsgBox userName

3. メモとして残す

後で再利用する予定のコードや注意事項を残すのにも便利です。

' この処理はバージョン2.0で有効にする
' Call AdvancedCalculation()

複数行をまとめてコメントアウトするには?

VBAには、1つの記号で複数行をコメントアウトする機能はありません。
ですが、以下の方法で効率的に複数行をコメントアウトできます。

方法1:1行ずつ ' をつける

'Dim a As Integer
'a = 10
'MsgBox a

これは地道ですが、基本的な方法です。

方法2:VBAエディターの「ツールバー」を使う

VBAのエディターには「編集ツールバー」があり、「コメントブロック」ボタンで複数行を一括コメントアウトできます。

編集ツールバーの表示方法:

  1. VBAエディターを開く(Alt + F11)
  2. メニューから「表示」→「ツールバー」→「編集」を選択
  3. 編集ツールバーに「コメントブロック」ボタンと「コメント解除」ボタンが表示される

複数行を選択して「コメントブロック」ボタンを押せば、すべての行に ' が付きます。


コメントアウトのショートカットキー

VBAエディターでは、便利なショートカットキーがあります。

  • コメントアウト:Ctrl + Shift + C
  • コメント解除:Ctrl + Shift + X

※このショートカットは編集ツールバーが有効な状態でのみ使えます。

作業効率を上げたい方は、ぜひショートカットを覚えておきましょう。


コメントを使うときの注意点

・無駄なコメントは避ける

コメントが多すぎると、逆に読みづらくなります。コードの意図が明確な場合、コメントは不要なこともあります。

' x に 1 を代入する ← 明らかなので不要
x = 1

・内容が変わったらコメントも更新する

コードを修正したのに、コメントが古いままだと混乱のもとになります。


コメントアウトの活用でVBAコードをもっと見やすく

コメントは「見えるメモ帳」です。将来の自分や他人が見てもわかるように、適切に使えば保守性の高いコードが書けます。
初心者のうちは「これはどういう意味だっけ?」と不安になることも多いですが、コメントを書いておくだけで安心してコードに戻ってこれます。

たとえば、マクロを複数人で運用するチームや、長期間運用するシステムでは、コメントがあるだけで運用コストがぐっと下がります。


まとめ

VBAにおけるコメントアウトはとてもシンプルで、'(シングルクォーテーション)を使うだけです。
ですが、その使い方には工夫があり、効率よく記述・解除することで、コード管理やデバッグが楽になります。

  • ' を使って行頭に記述すればコメントアウト
  • 複数行は「編集ツールバー」や「ショートカット」で一括処理
  • 無駄なコメントは避け、内容が変わったら更新

コメントを上手に使うことで、あなたのVBAコードはもっと分かりやすく、使いやすくなります。
ぜひ今日から、コメントアウトを意識して使ってみてください!

upandup

Web制作の記事を中心に、暮らし、ビジネスに役立つ情報を発信します。 アフィリエイトにも参加しています。よろしくお願いいたします。