Go言語のコメントの書き方ガイド！1行・複数行コメントの使い分け

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

生徒

「Go言語でプログラムの説明を書きたいんですけど、どうすればいいですか？」

先生

「それなら『コメント』を使うといいですね。コメントは、プログラムの動作に影響を与えないメモのようなものです。」

生徒

「へぇ、メモが書けるんですね！でも、どうやって書くんですか？」

先生

「それでは、Go言語におけるコメントの書き方を1つずつ見ていきましょう。」

1. コメントとは何か？初心者でもわかる基本のキ

Go言語（Golang）における「コメント」とは、プログラムの動作には影響しない説明文のことです。コメントに書いた内容は、コンピュータが実行する処理には含まれないため、安心して自由にメモを書くことができます。

主な役割は、「このコードは何をしているのか」「なぜこの処理が必要なのか」を人に伝えることです。自分が後から読み返すときだけでなく、他の人がコードを見るときにも理解しやすくなります。

たとえば、初めて見るプログラムでもコメントがあれば、処理の流れを文章として追えるため、プログラミング未経験者でも内容をつかみやすくなります。

コメントは、このようにコードの説明として使われます。


package main

import "fmt"

func main() {
    // あいさつのメッセージを表示する
    fmt.Println("こんにちは")
}

この例では、//から右側がコメントです。「何をしているコードか」を日本語で書いておくことで、処理の意味が一目で分かります。

Go言語では、コメントの書き方は次の2種類に決まっています。用途に応じて使い分けることで、コード全体が読みやすくなります。

1行コメント：短い説明を1行で書きたいとき
複数行コメント：処理の概要や注意点をまとめて書きたいとき

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

1行コメントは、その行の処理内容を簡単に補足したいときに使います。Go言語では // を書いた位置から行の終わりまでがコメントとして扱われ、プログラムの実行には一切影響しません。

処理の直前に書いて「これから何をするか」を説明したり、コードの横に書いて「この行の意味」を補足したりと、使い方はとても自由です。短く要点だけを書けるため、初心者が最初に覚えるコメントとして最適です。

基本的な1行コメントの書き方を見てみましょう。


package main

import "fmt"

func main() {
    // 画面に「こんにちは」と表示する
    fmt.Println("こんにちは")
}

このように、処理の上にコメントを書くと「何をするコードなのか」が一目で分かります。後から読み返したときにも理解しやすくなります。

1行コメントは、コードの横に書くこともできます。


func main() {
    fmt.Println("こんにちは") // あいさつメッセージを表示
}

この書き方は、処理がシンプルな場合に便利です。ただし、コメントが長くなりすぎると読みにくくなるため、短くまとめるのがコツです。

1行コメントは「この行で何をしているか」を補足するためのものなので、コードを見れば分かることを書きすぎないように意識すると、読みやすいプログラムになります。

3. 複数行コメントの書き方と使いどころ

複数行コメントは、2行以上にわたる説明を書きたいときに便利です。Go言語では /* でコメントを始めて */ で閉じることで、その間に書いた文章がすべてコメントになります。プログラムの実行には影響しないので、処理の目的や注意点をまとめて残せます。

「このファイルは何をするのか」「なぜこの書き方にしているのか」など、少し長めのメモを書きたいときは複数行コメントが向いています。1行コメントを何行も並べるより、ひとかたまりで読めるので見通しが良くなります。

複数行コメントの基本形は次のとおりです。


package main

import "fmt"

func main() {
    /*
        このプログラムは、
        あいさつのメッセージを表示します。
        初心者向けのサンプルです。
    */
    fmt.Println("こんにちは")
}

/*と*/で囲まれた部分は、何行書いてもまとめてコメントになります。長い説明でも、コードの流れを邪魔しにくいのが特徴です。

たとえば「一時的にまとめて無効化したい」場合にも複数行コメントが使えます。


package main

import "fmt"

func main() {
    /*
    fmt.Println("テスト表示1")
    fmt.Println("テスト表示2")
    */
    fmt.Println("本番で使う表示")
}

このように、複数の行をまとめてコメントにできるので、動作確認の途中で一部を外したいときに役立ちます。ただし、必要な箇所まで消してしまわないように、範囲には気をつけましょう。

4. コメントはどう使い分ける？初心者にもおすすめの使い方

コメントは「とりあえず書けばいい」というものではなく、場面に応じて使い分けることで、コードの読みやすさが大きく変わります。特にGo言語では、シンプルなコードを書く文化があるため、コメントも役割を意識して使うことが大切です。

基本的な考え方としては、「今この行だけを説明したいのか」「プログラム全体の前提を伝えたいのか」で判断すると迷いにくくなります。

1行コメント：その行の処理内容や理由を短く補足したいとき
複数行コメント：プログラム全体の目的や注意点を最初にまとめて伝えたいとき

たとえば、最初に全体像を複数行コメントで説明し、その下で各処理を1行コメントで補足すると、初心者でも流れを追いやすくなります。


package main

import "fmt"

/*
    ユーザーに挨拶をするプログラム。
    画面にメッセージを表示します。
*/

func main() {
    // あいさつを表示する
    fmt.Println("こんにちは、世界！")
}

このように使い分けることで、「最初に概要を理解し、次に細かい処理を見る」という自然な読み方ができるコードになります。

5. コメントを書くときの注意点とおすすめの書き方

Go言語でコメントを書くときのポイントは次のとおりです。

読みやすい言葉で書く：自分だけでなく他人が見ても理解しやすい表現にする
簡潔に書く：必要なことだけをシンプルに書く
間違った情報を書かない：コードと内容が合っていないコメントは混乱のもとです

また、Go言語ではプログラムの冒頭でパッケージや関数の説明にコメントを書く「ドキュメントコメント」もよく使われます。これも1行コメント（//）を使って書かれます。


// main関数はプログラムの開始点です
func main() {
    fmt.Println("Goのコメント、覚えましたか？")
}

6. コメントを無効化してコードを試すときにも便利！

初心者がよく使うテクニックとして、「一時的にコードを止めたいときにコメントにする」という使い方があります。

たとえば、ある処理がまだ完成していない、または一旦外したいというときは、コメントにしておくとあとで元に戻せます。


func main() {
    // fmt.Println("ここは後で使う予定です")
    fmt.Println("動作確認中")
}

このように、コメントは「説明」だけでなく、「一時停止」のような使い方もできて便利です。

まとめ

Go言語のコメントは、初心者でも安心して読み書きできる非常に便利な仕組みであり、コードの理解を深めたり将来の修正を楽にしたりするために欠かせない存在です。特に、Go言語では一行コメントと複数行コメントの二種類が用意されており、これらを状況に応じて使い分けることで、効率的にコードの意味を整理できます。さらに、コメントには開発中の作業メモとして活用する場面も多く、特に大規模なプログラムや複数人での開発では、コメントの書き方ひとつで理解しやすさが大きく変わります。コメントは単なる説明文ではなく、プログラミングの品質を支える重要な技術ともいえます。

一行コメントと複数行コメントの実践的な使い分け

一行コメントはその名の通り一行で使う形式で、簡潔な注意書きや処理の補足説明に向いています。コードの右側に添えることで、処理の意味をさりげなく示すことができます。一方、複数行コメントは複数の説明をまとめたいときに役立ち、関数やプログラム全体の説明を記述したり、重要なルールを明記したりする際に活用されます。特にGo言語ではドキュメントコメントも多く使われ、これによって外部ツールによる自動生成も容易になります。

コメントの書き方例と実用シーン

コメントを使いこなすためには、具体的な使い方を理解しておくことが大切です。たとえば、関数の上に説明を書いておくと、その関数がどのような目的を持つのか一目でわかりますし、処理の流れを追う際にも役立ちます。以下に、まとめとして実践的なサンプルコードを紹介します。


package main

import "fmt"

/*
    ユーザーに対してあいさつを表示するサンプルプログラム。
    コメントの役割と使い方をまとめとして示しています。
    初心者でも読みやすく保つため、各処理に説明を添えています。
*/

// main関数ではあいさつを表示します
func main() {
    // あいさつメッセージを出力する
    fmt.Println("こんにちは！Go言語のコメントを理解しました。")
    
    // ここで追加の処理が必要になった場合、一時的にコメントアウトできます
    // fmt.Println("この行は今は使いません")
}

コメントを適切に使うことで、コードはより読みやすく、安全で、修正しやすいものになります。特にGo言語では構造がシンプルで扱いやすいため、初心者でもコメントを活かした整理整頓がしやすく、学習効率も高まります。プログラムを書き進める過程で、どのような意図で記述したのかを残しておくことは、未来の自分や他の開発者への思いやりにもつながります。読み返したときに「なぜこうしたのか」がすぐに理解できるようになるので、ぜひ今日から一行コメントと複数行コメントを使いこなしていきましょう。

先生と生徒の振り返り会話

生徒

「コメントってこんなにいろいろな使い方があったんですね。説明だけじゃなくて、一時的にコードを止めるためにも使えるなんて便利です！」

先生

「そうでしょう。Go言語ではコメントの書き方がシンプルなので、初心者にも扱いやすいんです。特に関数の上に書く説明コメントは、コードを読み返すときにとても役に立ちますよ。」

生徒

「一行コメントと複数行コメントの使い分けも理解できました！説明だけしたいときと、長めの注意書きを書きたいときで変えるんですね。」

先生

「その通りです。書き分けられるようになると、プログラムがぐっと見やすくなるので、積極的に使ってみてください。」

生徒

「はい！これからは、読み返したときに分かるように丁寧にコメントを書いていきます！」

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。