Pythonで複数行コメントアウトする方法を初心者向けにわかりやすく解説

プログラミング言語•2025/2/16

Python

はじめに

Pythonでコードを書く際、コメント はコードの意図を明確にしたり、一時的に処理を停止したりするときに使われます。

ただし、PythonにはC言語のような /* */ や、他の言語にある公式な複数行コメントの構文がありません。

しかし工夫次第で、複数行をまとめてコメントアウトすることができます。

この方法を知っておくと、作業効率が上がったり、共同開発での意思疎通がスムーズになることもあります。

本記事では、Python初心者の皆さんに向けて、複数行コメントアウトの方法と実務上での使いどころをわかりやすく解説していきます。

短めのサンプルコードを交えながら説明するので、ぜひ気軽に読み進めてみてください。

この記事を読むとわかること

Pythonで使えるコメントアウトの基本
複数行コメントアウトの具体的な方法とその使い分け
実務シーンで役立つコメントアウトの応用例
コメントに関するベストプラクティスや注意点

Pythonのコメントとは何か

Pythonにおけるコメントとは、コードとして実行されないメモ書きのようなものです。

コードの可読性向上や、ほかの開発者との情報共有を目的として多用されます。

多くの場合は # を使って1行ずつ書きますが、ときには複数行をまとめて無効化したい場面もあるでしょう。

このようなときに、Pythonならではの方法を知っていれば、大量のコードを変更・復元する作業がとてもスムーズになります。

Pythonにおけるコメントの基本

Pythonでは、行頭もしくは行の途中に # を置くと、そこから先の文字列はすべて実行されません。

この仕組みによって、プログラム内部に説明文やメモを挿入できます。

一方で、行中に # を入れれば、そこから先だけがコメント扱いになり、残りのプログラムとは分離されます。

コードを書くときに、少しだけ補足が必要な箇所なら1行コメントで十分かもしれません。

しかし、ソースコード全体にわたって長い説明が必要だったり、まとまった処理をまとめて無効化したい場合には、もう少し工夫が必要です。

コメントとコード可読性

コメントが適切に使われたコードは、開発者にとって理解しやすいものになります。

特にチームでの開発や、将来的に別の人がメンテナンスする可能性があるプロジェクトでは、コメントの有無が作業効率を左右することがあります。

ただし、コメントが多すぎると逆に見にくくなり、重要な部分が埋もれるリスクもあります。

複数行コメントアウトを活用する場合も、必要最低限にしつつ、可読性を保つためにバランスを意識しましょう。

複数行コメントアウトの方法

Pythonには明示的な複数行コメントアウトの構文がありません。

しかし、実質的に複数行のコードを無効化する方法として、

行頭に # を連続してつける方法
文字列リテラル (""" や ''') を使う方法

この2つがあります。

ここでは、それぞれの使いどころやメリット・デメリットを解説します。

1行ずつ#を使う方法

最もシンプルな方法は、対象となる行にすべて # をつけるやり方です。


# print("行1")
# print("行2")
# print("行3")

実務では、テキストエディタやIDEのコメントアウト機能を使うことがほとんどです。

たとえば、Visual Studio Codeなどではキーボードショートカットでまとめて # を付与・除去できるので、作業効率が良いでしょう。

メリット

明確に1行ずつコメントアウトの対象がわかる
実際に複数行コメントの構文がなくても対応できる
ほぼすべてのIDEやテキストエディタでショートカットが用意されている

デメリット

コード量が多い場合、手動で # をつける作業が手間
大量行のコメントアウトだと、見た目が煩雑になりがち

このように、行頭に # を付ける方式はオーソドックスですが、大きなコードブロックを一度に無効化する際に、作業量が増えることもあります。

文字列リテラルを使う方法

Pythonの文字列リテラルを使って、複数行をまとめて書くことができます。

よく知られているのは """ (三重引用符) または ''' (三重引用符) で囲む方法です。

たとえば、次のようなコードを書いたとします。


"""
print("行1")
print("行2")
print("行3")
"""

この部分は、Pythonの動作から見ると単なる文字列として扱われ、どこにも代入されないため、実質的に無視されます。

ただし、文字列リテラルはあくまでコード上は文字列として見なされる点に注意してください。

もし何かしらの意味で利用される場所に書いた場合、予期しない動作を引き起こす可能性があります。

メリット

ブロック全体を一瞬で無効化できる
""" や ''' で囲むだけなので、記述が楽

デメリット

あくまで単なる文字列リテラル扱いなので、完全な「コメント」とは言えない
処理の流れの邪魔にならない位置に書く必要がある

実務の中では、関数の外やクラス定義の外などに書く分には問題ありません。

しかし、クラス定義や関数内に三重引用符をそのまま書くと、ドキュメント文字列のように解釈されるケースがあり、予期しない結果になる恐れがあります。

複数行コメントアウトが必要となる場面

単純に1行ずつコメントアウトするだけで問題ないケースもあります。

しかし、実務や開発環境によっては一度にまとまった行を無効化したい場合が少なくありません。

ここでは、実際の開発現場で複数行コメントアウトが有用となる例をいくつか挙げてみましょう。

実務例：一時的にコードを無効化したい場合

たとえば、新しい機能を開発中に、既存の処理を部分的に止めておきたいケースがあるでしょう。

挙動を比較するために、一時的に処理Aと処理Bを切り替えるようなシチュエーションも考えられます。


# こちらは使わない処理
"""
user_input = input("何か入力してください: ")
print("あなたが入力したのは:", user_input)
"""

# こちらを使用する処理
print("固定メッセージを表示します。")

このように、新しい処理だけを残して動作確認するケースでは、複数行コメントアウトが効率的です。

もしコメントアウトをすべて手動で行うなら、多数の行に # を付ける必要があるかもしれません。

しかし、三重引用符を使えば、さっと一括で無効化できます。

実務例：ドキュメンテーションへの応用

Pythonでドキュメンテーションを行う際には、docstring という機能を使って関数やクラスの説明を記述することが一般的です。

以下のように書くと、関数の説明書きとして扱われます。


def sample_function(arg1, arg2):
    """
    この関数はサンプルとして使われます。
    arg1: 文字列
    arg2: 数値
    """
    print(arg1, arg2)

ただし、このようなdocstringはコメントというよりも関数やクラスに紐づく公式な説明文です。

実際には内部で文字列として扱われ、 help() などで参照される場合もあります。

ここで三重引用符を使う方法を複数行コメントと混同してしまうと、不要な箇所にdocstringができてしまう可能性があります。

そのため、docstringと複数行コメントを区別して使うことが大切です。

コメントのベストプラクティス

コメントを上手に活用することで、コードの意図を正しく伝えたり、チーム開発を円滑に進めることが期待できます。

逆にコメントが雑だと、かえって混乱を招く場合もあります。

ここでは、複数行コメントアウトに限らず、コメント全般のベストプラクティスを簡単に紹介します。

過度なコメントの注意点

多くの初心者の方が、コードのあらゆる行にコメントを書きすぎる傾向があります。

一行ごとに詳細すぎる説明を入れてしまう
同じことを繰り返し書いてしまう
コメント自体が古くなり、現状のコードと合わなくなる

このような状況に陥ると、コメントを信じてコードを読んだ人が誤解してしまうこともあります。

コメントはわかりにくい処理や意図を補足するために使うのが基本です。

実装内容そのものをすべて文章化するのはおすすめしません。

適切なコメントの書き方

コメントを書くときは、コードの意図や、ビジネスロジックの背景を説明すると良いでしょう。

Pythonの文法上、何をしているかはコードを読めばわかることが多いです。

それでもコメントが必要なケースは、あくまで「なぜこれをしているのか」「どうしてこの方法なのか」という意図に関する部分が中心となります。


# 通信エラーが起きても処理を継続するため、
# 例外をキャッチして再試行する。
try:
    response = send_request(url)
except ConnectionError:
    # 再試行をここで実行
    response = retry_send_request(url)

このようなコメントがあると、他の開発者がコードを読むときにスムーズに理解できます。

また、複数行コメントアウトを使う場合も「このブロックは将来的に使う予定がある」「動作確認のために止めている」など、意図を補足しておくと混乱が減るでしょう。

コメントに関連するPythonの便利な使い方

ここまで複数行コメントアウトの具体的な方法と、コメント全般のベストプラクティスについて説明してきました。

次は、コメントと関連して知っておくと便利なPythonの活用方法を少しだけ取り上げます。

エディタのコメント機能

現代の多くの開発エディタやIDEは、まとめてコメントアウトするショートカット機能を備えています。

Visual Studio Code
PyCharm
Atom
Sublime Text など

これらを利用すれば、大量の行を素早くコメントアウトしたり、また元に戻すのもボタン一つで実行できます。

手作業で複数行に # を付けるよりも効率的なので、ぜひ活用してください。

エディタによっては選択範囲に一括で # をつけたり外したりするだけでなく、フォーマット機能と連動してインデントも保持したままコメントアウトできるものがあります。

バージョン管理との連携

複数行をコメントアウトする背景には、コードの切り替え や 動作の比較 といった目的がある場合も多いはずです。

たとえば新しい機能を実装中に、旧バージョンのコードを一時的に残しておきたい状況が考えられます。

しかし、ソースコード管理システム（Gitなど）を利用していると、過去のバージョンを後で簡単にチェックアウトできます。

そのため、「あとで戻すかもしれないからコメントアウトして残しておく」という発想よりも、「過去のバージョンはGitで管理し、新しいコードだけを本番に残す」という運用のほうがシンプルな場合があります。

もちろん、必要に応じて複数行コメントアウトは便利な手段です。

ただし、コミット履歴との兼ね合いを考えると、実務においては「コメントアウトして古いコードを残す」方法を多用しすぎないように意識することも大切です。

よくある質問とトラブルシューティング

複数行コメントアウトをめぐって、初心者の方々が疑問を感じることやトラブルとなりやすい点をまとめてみましょう。

コメントアウトしすぎてコードが分からなくなる場合

あまりに多くの行をコメントアウトした状態のまま放置していると、どの部分が実際に動いていて、どの部分が無効化されているのかが分かりにくくなります。

これに対しては次のような対応策があります。

不要になったコードはこまめに削除する
バージョン管理システムで必要に応じて過去の履歴を参照する
大量のコメントアウトが必要な場合は、目的を明確にしておく

コードの保守性を高めるためにも、大規模なコメントアウトは一時的な用途に留めましょう。

チーム開発でのコメントルール設定

チーム開発を円滑に進めるために、開発メンバー内で「どのようにコメントを書くか」という共通ルールを持っておくと良いでしょう。

1行コメントと複数行コメントアウトの使い分け
Docstringの取り扱いと、ただのメモ的コメントの区別
長期的に使わないコードをコメントアウトして残す判断基準

これらをあらかじめ決めておくと、余分な混乱を減らせます。

また、コードレビューの際には「このコメントは本当に必要か」「複数行コメントアウトを続けるべきか」など、意識的に確認するのも効果的です。

まとめ

Pythonでは、C言語などのような公式の複数行コメント構文がありません。

しかし # を使った方法や三重引用符を用いることで、実質的に複数行をまとめてコメントアウトすることが可能です。

この機能は、開発中に一時的にコードを無効化したい場面や、大量の行をわかりやすくまとめたい場合などに非常に便利です。

また、コメントはあくまでも「コードの意図や補足情報を伝える」ために存在しており、書きすぎると逆効果になることもあります。

必要なときに必要なコメントを書き、不要になったら削除するかGitなどでバージョン管理する、という意識を持っておくことが大切です。

Pythonで開発を行う上で、コメントを上手に活用すれば、チーム開発の効率も向上し、バグの原因となるような誤解も減らせるでしょう。

実務シーンではエディタやバージョン管理を組み合わせながら、最適なタイミングで複数行コメントアウトを取り入れてみてください。