Pythonでコメントアウトを書く方法【初心者向け】

初心者向けにPythonのコメントの書き方について解説しています。コメントアウトを使うとコード内に説明を記述し、可読性を高めることができます。Pythonでコメントを入れる場合の書き方を覚えておきましょう。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonのコメントの書き方について解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事をまずご覧ください。

 

なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。

 

田島悠介

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

大石ゆかり

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

田島悠介

コメントの書き方について詳しく説明していくね!

大石ゆかり

お願いします!

 

コメントアウトとは

ソースコード上に記述されているが、実行されない箇所をコメントと言います。言い換えると、ソースコードの見た目だけに影響し、機能に影響しないものです。

ソースコードに解説を加え、可読性や保守性を向上させるためにコメントを記述します。複数人で1つのプロジェクトを行う場合、それぞれのソースコードがどういう意味を持っているのか認識をすり合わせる必要があります。

より効率的に開発を行うためにもコメントを書くことに慣れておくと良いでしょう。

ある範囲のソースコードをコメントにすることを、「コメントアウトする」と言います。

 

コメントの書き方

‘#’から行末までがコメントになります。

Pythonには複数行をまとめてコメントにする機能はありません。

a = 1

# 行の先頭からコメントとする
# b = 2

# 行の途中からコメントとする
c = 3 # コメント

# 複数行コメント
# d = 4
# e = 5

 

[PR] Pythonで挫折しない学習方法を動画で公開中

実際に書いてみよう

サンプルコード

print('foo')
# print('bar')

実行結果

foo

解説

1行目が実行され、fooと表示されました。

2行目はコメントアウトされているので、実行されませんでした。

 

監修してくれたメンター

橋本紘希

システムインテグレータ企業勤務のシステムエンジニア。
開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

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

田島悠介

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

大石ゆかり

分かりました。ありがとうございます!

オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。

初心者向けの書籍を使って人工知能(AI)や機械学習について学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。