VB.NETのコメントの書き方ガイド！1行・複数行コメントの基本と使い分け

先生と生徒の会話形式で理解しよう

生徒

「VB.NETでプログラムを書いているときに、自分用のメモとか説明を書きたいんですけど、どうすればいいですか？」

先生

「それには“コメント”という仕組みを使います。コメントはプログラムに書いても動作に影響しない説明文です。」

生徒

「コメントってどうやって書くんですか？1行だけじゃなくて、長い説明もできるんですか？」

先生

「VB.NETでは1行コメントと複数行コメントがあります。順番に基本から見ていきましょう。」

1. コメントとは？

コメントとは、プログラムの中に書いても処理には影響しない「説明文」や「メモ」のことです。VB.NETのコードの横や上に小さなメモを書いておくイメージで、「この変数は何のため？」「この処理は何をしている？」といった情報を残しておくために使います。

VB.NETでコメントを書いておくと、数日後や数か月後に自分で見返したときでも「ああ、このコードはこういう目的だったんだな」とすぐに思い出せます。プログラミング未経験の人ほど、最初は処理の流れや変数の意味を忘れやすいので、コメントを残しておくことは学習の助けにもなります。

例えば、次のような簡単なVB.NETのプログラムを見てみましょう。


' あいさつメッセージを表示する簡単なプログラム
Dim name As String = "太郎"   ' 名前を入れるための変数
Dim message As String = "こんにちは、" & name & "さん"  ' 画面に出す文章

Console.WriteLine(message)   ' メッセージを画面に表示する


こんにちは、太郎さん

上の例では、行の先頭にある'から始まる行や、コードの右側に書かれた文章がコメントです。コメント部分はVB.NETのコンパイラからは「説明」として扱われ、実際の処理には一切影響しません。そのため、安心して日本語でメモを書いたり、処理の意味を丁寧に説明したりできます。

コメントをしっかり書いておくと、自分だけでなく、他の人があなたのVB.NETコードを読んだときにも理解しやすくなります。将来の自分やチームメンバーへの「読みやすさのプレゼント」だと思って、気になったところには積極的にコメントを入れていくとよいでしょう。

VB.NETのコメントには次の2種類があります。

1行コメント（短い説明や一言メモを書きたいとき）
複数行コメント（少し長めの説明や処理の流れをまとめたいとき）

これらのコメントの書き方や具体的な使い分けを理解しておくと、VB.NETのプログラムがとても読みやすくなり、後から修正するときもスムーズに作業できます。

2. 1行コメントの書き方

VB.NETで1行コメントを書くときは、行の先頭や途中に'（シングルクォート）を入力します。'より右側に書かれている部分は、すべて「コメント」として扱われ、プログラムとしては実行されません。「この行は説明だけ」「この変数はこういう意味」といったメモを書きたいときに使います。

1行コメントには、主に次のような書き方があります。

行の先頭に'を書いて、その行全体を説明用のコメントにする
コードを書いたあと、行の途中から'を書いて、その右側だけを説明にする

実際のVB.NETコードで確認してみましょう。プログラミング未経験の方でも、コメントの場所に注目して読んでみてください。


' これは1行コメントの例です（この行は説明だけで、処理は行われません）
Dim a As Integer = 10    ' 変数aに10を代入する処理
Console.WriteLine(a)     ' 変数aの値を画面に表示する処理

上のコードでは、最初の行は先頭に'が付いているので、行全体がコメントです。2行目と3行目は、左側が実際のVB.NETの処理、右側が「この処理は何をしているのか」を説明するコメントになっています。どちらもコンピューターから見ると「説明文」として無視されるため、書いてあってもプログラムの結果は変わりません。

このように、シングルクォートから右側はプログラムとしては無視されるため、「一言メモ」や「日本語の説明」を気軽に書くことができます。どの行が何をしているのかをその場で説明しておくことで、後から自分が読み返したときにも理解しやすくなり、VB.NETの学習や実務でのコード管理がぐっと楽になります。

最初のうちは、少し説明しすぎかな？と思うくらいでも構いません。「この行は何をしているか」「この変数は何を表しているか」を1行コメントで残す習慣をつけておくと、プログラムの見通しがよくなり、バグを見つけるときにも役立ちます。

3. 複数行コメントの書き方

VB.NETには「複数行コメント専用の記号」はありません。その代わりに、1行ごとに'をつける方法を使います。


' ここから複数行コメントの例
' このプログラムは2つの数を足します
' a と b の値を加算して結果を表示します
Dim a As Integer = 5
Dim b As Integer = 7
Console.WriteLine(a + b)

一見面倒ですが、複数行にわたって丁寧に説明したいときには役立ちます。Visual Studioなどの開発環境では、複数行を選択してCtrl + K、Cを押すと、自動でコメントがつけられるので効率的です。

4. コメントを使うと便利な場面

コメントは単なるメモ書きではなく、プログラムを理解しやすくするための大切な道具です。特に次のような場面で使うと効果的です。

変数や定数の意味を説明するとき
処理の手順を整理するとき
一時的にコードを無効化したいとき


Dim price As Integer = 1000 ' 商品の価格
Dim tax As Double = 0.1     ' 消費税率
Dim total As Double = price * (1 + tax)

' 次の行は一時的に使わない
' Console.WriteLine("デバッグ用: " & total)

Console.WriteLine("税込価格: " & total & "円")


税込価格: 1100円

このようにコメントを入れると、後で自分や他の人がコードを読んだときにすぐ理解できます。

5. コメントを書くときのコツ

初心者がVB.NETでコメントを書くときに覚えておくと良いポイントをまとめます。

コメントは「なぜこの処理をしているか」を書くと効果的
プログラムの内容をただ繰り返すだけのコメントは不要
後から見たときに理解できるように、自分への説明だと思って書く
複数行コメントを多用するときは、整理して読みやすく配置する

例えば次のように「目的」を書くと読みやすくなります。


' 合計金額を計算して表示する処理
Dim a As Integer = 300
Dim b As Integer = 500
Dim sum As Integer = a + b
Console.WriteLine("合計は " & sum & " 円です")


合計は 800 円です

単に「aとbを足す」と書くより、「合計金額を計算する」と書いたほうが目的が分かりやすいですね。

まとめ

VB.NETでコメントを書くことは、初心者だけでなく経験者にとっても非常に重要な作業です。特に一行コメントと複数行コメントを正しく使い分けることで、コードの読みやすさが大きく向上し、あとから見返したときの理解度も高まります。今回の記事では、シングルクォートによる基本的なコメント記述方法、複数行コメントの扱い、開発効率を上げるショートカット、さらに実際のプログラム例を通してコメントの役割を学びました。ここでは振り返りとして、VB.NETのコメントを効果的に活用するためのポイントをより深く整理していきます。

コメントを書く目的は単にコードの説明をするだけではなく、「この処理はどういう意図で書かれているのか」「なぜこの値を採用しているのか」といった背景を残すことにあります。特に複雑なロジックや業務システムの処理では、コメントがあるだけで理解のスピードが大きく変わります。また、チーム開発ではコメントの質がプロジェクト全体の品質にも影響します。丁寧で簡潔なコメントを心がけることで、保守性が高まり、ほかのメンバーにも役立つコードになります。

さらに、VB.NETでは複数行コメント専用の記号が存在しないため、複数行にわたる説明を丁寧に書くには一行ごとにシングルクォートを付けるという基本操作を理解しておく必要があります。この特性を逆に活かし、必要な部分だけを選んでコメント化することで、コードの動作確認を柔軟に行うこともできます。また、Visual Studioのショートカット操作を使えば、複数行に一括でコメントを付けたり外したりできるため、長めのコードでも効率的に編集できます。

コメントを付ける際のコツとして、読み手にとって価値のある情報を書くこと、そしてコード自体に書いてある内容をそのまま繰り返さないことが挙げられます。例えば「a に 10 を代入」というような説明はコードを見れば分かるため、コメントとしての価値は低いと言えます。それよりも「この値は設定画面から取得したユーザー入力を基準に計算される」など、意図や背景を示すほうが読みやすく、将来の修正にも役立ちます。

サンプルプログラムで再確認しよう

ここでは、コメントの使い方をまとめた例をもう一度掲載します。


' 合計金額を計算して表示する処理
Dim price As Integer = 1200   ' 商品価格
Dim tax As Double = 0.1       ' 税率
Dim total As Double = price * (1 + tax) ' 税込み金額の計算

' デバッグ用に一時的に出力したいとき
' Console.WriteLine("計算結果: " & total)

Console.WriteLine("税込価格は " & total & " 円です")