Pythonのコメントの書き方|#で考えたことを残そう

Pythonのコメントは、コードに残す自分や仲間へのメモです。半角の#から行の終わりまでがコメントになり、命令としては実行されません。ゲームのHPを題材に、メモと命令を分け、試したことを記録する練習をしましょう。

学習ガイド・教材一覧へ

Pythonのコメントの書き方をブラウザで試そう

見本の結果を予想して「実行する」を押します。結果を見たら、数字や言葉を1か所変えて再実行しましょう。3つの実験は自由に選べます。

今のコードを残す

表示中の実験のコードを保存します。ページを離れると編集内容は消えます。

今のコードを残す

表示中の実験のコードを保存します。ページを離れると編集内容は消えます。

保存した.pyファイルを、VS Codeで動かす方法(別タブ)

インストール・ログインは不要です。PCの最新版Chrome・Edgeを推奨します。初回はPythonの読み込みに少し時間がかかります。編集内容はページを閉じると消えるので、残したいコードはコピーして保存してください。

1.どうしてこの数にしたの?

コメントの日本語も結果に出ると思いますか?

# 初めて遊ぶ人が試しやすいHPにする
hp = 80
print(hp)

#の行は読み手のための説明です。「何をしているか」だけでなく「なぜそうしたか」を残すと、あとで調整しやすくなります。

変えてみよう:HPを変えて、変更した理由をコメントに残しましょう。

迷ったときのヒント

メモを書き換えても計算結果は変わりません。hpの値を変えると結果が変わります。

2.回復する行を休ませよう

回復する行の先頭に#があります。最後のHPは?

hp = 80
hp = hp - 25
# hp = hp + 10
print(hp)

命令を消さずに一時的に動かさないようにすることをコメントアウトと呼びます。実験の前後を比べるのに便利ですが、残した理由が分からない古い行は整理しましょう。

Pythonのコメントは半角の#から始まります。回復する行をコメントアウトすると、HPは55のままです。
Pythonのコメントは半角の#から始まります。回復する行をコメントアウトすると、HPは55のままです。

変えてみよう:3行目の#だけを外して、結果の違いを確かめましょう。

迷ったときのヒント

#を外すと、その行は再び命令として実行されます。

3.引用符の内側はどうなる?

どちらの#が画面に残るでしょう?

print("#冒険日記")  # 今日の見出し
print("出発!")

引用符の内側の#はコメントの始まりではありません。1行目は#冒険日記と表示し、その後ろの行末コメントは表示しません。

変えてみよう:見出しを別の文字に変え、行末のメモも自分の言葉にしましょう。

迷ったときのヒント

引用符の内側の#は、文字列の一部です。

複数行のメモも、1行ずつ#を付ける

# 予想:回復を増やすと最後のHPが増える
# 観察:10増やすと、結果も10増えた
print("記録できた")

三重引用符で囲むものは文字列です。コメント専用の構文ではありません。初めは各行に#を付ける書き方にそろえましょう。

メモとコードを一緒に直す

コードを変えたのに、コメントだけ昔の説明のままだと読み手が迷います。実行後に「いまの動きと説明が合っているか」も見直します。

よくある疑問と、困ったときの確認

コメントを付けると実行結果が変わりますか?

通常の説明コメントを足すだけなら変わりません。ただし命令の前に#を付けると、その命令が実行されなくなるため結果が変わります。

全角の#でも使えますか?

コメントの始まりには半角の#を使います。見た目が似ている文字に気を付けましょう。

エラーが出たら、実行欄の日本語の案内と行番号を手がかりに、1か所ずつ確かめます。Pythonのエラーの読み方も使えます。

振り返って、次のチャレンジへ

何を予想し、どこを変え、結果がどう変わったかを一言で説明してみましょう。答えが違ったところも、次の実験の手がかりです。

前の教材:Pythonの文字列

次の教材:Pythonのinput()を数値にするには?intと文字列の違い →

学習ガイドに戻る / Python・VS Codeの環境構築

詳しい仕様:Python公式ドキュメント。まずは上の短い例で動きを確かめてから、必要な項目を読んでみましょう。