Pythonでプログラムを書き始めると、コードの中に説明を書きたくなります。
そのときに使うのがコメントです。
この記事では、コメントとは何かから始めて、基本的な書き方と考え方を順番に説明します。

この記事でわかること

  • コメントとは何か
  • 1行コメントの書き方
  • 複数行コメントの書き方
  • コメントの使い分け方

完成コード(まず見てみよう)

# あいさつを表示します
print("Hello Python")

コメントとは何か

コメントは、プログラムの説明を書くためのメモです。
Pythonでは、コメントに書いた内容は実行されません。
人が読むための文字だと考えてください。

後から見返したときや、他の人が読むときに役立ちます。

1行コメントの書き方

Pythonでは、#を書くとコメントになります。
#から後ろは、すべてコメントとして扱われます。

# 画面に文字を表示します
print("こんにちは")

この例では、printの行だけが実行されます。
コメントの行は無視されます。

複数行コメントの書き方

複数行にわたって説明を書きたい場合は、三つのダブルクォーテーションを使います。

"""
このプログラムは、
画面にあいさつを表示します。
"""
print("こんにちは")

このように書くと、説明文は表示されません。
printの行だけが実行されます。

使い分けの考え方

短い説明には、#を使った1行コメントが向いています。
少し長い説明や、まとめた説明には、複数行コメントが便利です。

初心者のうちは、次のことを覚えておけば十分です。

  • 1行なら#
  • 長めなら複数行

おじちくワンポイント

最初は、コメントを書きすぎても問題ありません。
自分が理解しやすい言葉で書いてください。
慣れてくると、必要なコメントだけが残ります。

よくある勘違い・注意点

  • コメントも実行されると思い込む
  • コメントを書かない方がよいと思う
  • 日本語を書いてはいけないと思う

練習問題

問題1
printの上に、その行の説明コメントを書いてください。

問題2
複数行コメントを書いて、実行結果が変わらないことを確認してください。

まとめ

  • コメントは説明用のメモ
  • #は1行コメント
  • 三つのダブルクォーテーションで複数行コメントが書ける
  • 初心者ほどコメントを書いてよい

次回の記事はこちらです。
Pythonの変数とは何かを初心者向けに解説

前回の記事はこちらです。
Pythonのprint関数の使い方を初心者向けに解説

目次はこちらです。
Python学習コンテンツ