Pythonでコメントを書く方法を徹底解説！基本の書き方と複数行コメントのコツ

Pythonにおけるコメントとは？

コメントとは、コンピュータプログラムのソースコード内に記述される、プログラマ向けの説明文や注釈のことです。コメントはコードの意図や処理内容を人間が理解しやすくするために書かれるものであり、コンパイラやインタプリタによって完全に無視されるため、プログラムの実行結果には一切影響しません。

Pythonでのコメントの基本的な書き方

Pythonスクリプトでは、#（シャープ）記号がコメント行の開始を表します。この記号以降から行末までがコメントとして扱われます。

• # が行の最初の文字であれば、その行全体がコメントになります。
• # は行の途中でも使用できます。その場合、# より前の部分は有効なPythonの式として実行され、# 以降のテキストのみがコメントとして無視されます。

以下に具体的な例を示します。

#これはコメントです
print("Hello World")
print("Welcome to TutorialsPoint")  #これもコメントですが、ステートメントの後に記述しています。

Pythonに複数行コメント（ブロックコメント）はない

Pythonには、C言語やJavaのような「/* ～ */」形式の複数行コメント（ブロックコメント）を記述する仕組みが標準では用意されていません。そのため、複数行にわたってコメントを書きたい場合は、各行の先頭に # を付ける必要があります。

ただし、多くのPython対応IDE（PyCharm、VS Codeなど）には、選択した範囲のステートメントを一括でコメント化・コメント解除できるショートカットキーが用意されているため、効率的に作業できます。

三重引用符を使った擬似的な複数行コメント

もうひとつのテクニックとして、三重引用符（''' または """）で囲まれた複数行文字列も利用できます。この文字列が関数やクラスのdocstring（ドキュメンテーション文字列）として割り当てられていない場合、実行時には評価されず、事実上コメントのように扱うことができます。

'''
comment1
comment2
comment3
'''
print("Hello World")

なお、関数・クラス・モジュールの直下に記述された三重引用符の文字列はdocstringとして認識され、help()関数などで参照可能になる点には注意しましょう。

まとめ

• Pythonのコメントは # 記号で始まり、行末までが有効。
• 行の途中にも記述でき、# 以降のみがコメント扱いになる。
• 標準の複数行コメント機能はないため、各行に # を付けるかIDEのショートカットを活用する。
• docstringでない三重引用符の文字列は、擬似的な複数行コメントとして使える。