Pythonにおける複数行コメントの記述方法を現役エンジニアが解説【初心者向け】
初心者向けにPythonにおける複数行コメントの記述方法について現役エンジニアが解説しています。コメントはソースコード内のメモのように書けて実行時には無視(スキップ)される行のことです。Pythonでコメントアウトするには1行コメントには#(シャープ)を使い、複数行には"'を3つつなげて書きます。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日 調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名 調査手法:インターネット調査
監修してくれたメンター
清水 源一郎
テックアカデミーでは、Pythonコース、AIコース、データサイエンスコースを担当。
Pythonにおける複数行コメントの記述方法について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。
目次
そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

今回は、Pythonに関する内容だね!

どういう内容でしょうか?

Pythonにおける複数行コメントの記述方法について詳しく説明していくね!

お願いします!
コメント機能とは?
プログラムを書く際、どの言語においても処理内容や関数の説明を載せるときにソースコードにメモ(コメント)を残します。
この機能をコメント機能またはコメントアウトといいます。
コメント機能を使うことでプログラムに影響することなくソースコード内にメモを残せます。
また、コメントアウトによってソースコードの一部を実行されないようにできます。
コメント機能は次のような目的で使われます。
- 自身でソースコードを見直す時に備えて、何を考えてそのコードを書いたのか記しておくため。
- 自分の意図を伝えることで、ソースコードを他の人にも理解しやすくするため。
- エラーの原因を探す際や、コードの書き方を試行錯誤する際に、特定の行を実行しないようにするため。
コメント機能の使い方
1行のコメント
1行でコメントアウトを行う際には#使って記述します。
例
# ここはコメント # print("ここもコメント、実行しない") print("ここは実行する")
複数行のコメント
今回の本題の複数行でのコメントです。
複数行でコメントを残すときには、シングルクォーテーションまたはダブルクォーテーションを3つつなげたもので両端を囲んでコメントアウトします。
この手法はGitHubで公開しているコードやドキュメント作成を行う際にはよく使用されます。
例
""" ここはコメントです。 実行はされません。 """ print("Hello World")
コメント機能を使って複数行のコメントをしてみよう
それでは、複数行のコメントをしてみましょう。
まずは以下のソースコードをコピーして任意の場所に保存しましょう。
def test(a): """引数 a:数字(int) """ return a + 1 print(test(2))
上記コードを実行すると、test関数に2を引数として渡した結果が返ってくると思います。
関数内のコメントで引数の説明を入れているのが分かります。
このようにして、関数の説明を行い引数を説明することで、引き継ぎで誰かにコードを渡す際に関数内の処理を知れてチーム開発の効率があがります。
複数行のコメントを行う際は、インデントに注意する必要があります。
関数の定義, if文などインデントを行うブロック内で複数行のコメントを行う場合は、上記コードのようにコメント部分もインデントを揃える必要があります。
実は私も!?独学で損する人の特徴
「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ
独学には向き不向きがあり、実はスクールが向いている人も大勢います。
そんな方のために参考として、
テックアカデミー卒業生がスクールを選んだ理由
をご紹介します。
- ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
- ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
- ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、
スクールが向いているかもしれません。
お試しのつもりで、まずは一度
無料相談
に参加してみませんか?
現役エンジニア・デザイナーに何でも気軽に相談できる30分
を
すべて無料で
できます。
無理な勧誘は一切ない
ので、お気軽にご参加ください。
まとめ
今回はPythonにおいてのコメント機能を紹介しました。
他人に自分のソースコードを読んでもらうためにコメントはとても大切です。
ただし、あまり使いすぎるとかえって読みづらくなるので、適度に使うようにしましょう。

内容が分かりやすくて良かったです!

ゆかりちゃんも分からないことがあったら質問してね!

分かりました。ありがとうございます!
Pythonを学習中の方へ
これで解説は終了です、お疲れさまでした。
- つまずかず「効率的に」学びたい
- 副業や転職後の「現場で使える」知識やスキルを身につけたい
プログラミングを学習していて、このように思ったことはありませんか?
テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。
合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能(AI)や機械学習の基礎を学べます。
まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。
時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!

プログラミングを独学していて、このように感じた経験はないでしょうか?
- ・調べてもほしい情報が見つからない
- ・独学のスキルが実際の業務で通用するのか不安
- ・目標への学習プランがわからず、迷子になりそう
テックアカデミーでは、このような
学習に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供
しています。
30分間、オンラインでどんなことでも質問し放題です。
「受けてよかった」と感じていただけるよう
厳しい試験を通過した講師
があなたの相談に真摯に向き合います。
「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」
こんな気持ちでも大丈夫です。
無理な勧誘は一切ありません
ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)