Top動画

このサイトをはじめて訪れる人へ

タイの田舎の暮らしと、AI・語学・仏教などの学びを“実験生活”として記録する個人メディアです。運営:ユリアナ・シンテシス。日々の小さな発見を、創作と実践の視点で読みやすくまとめています。

必ずこのサイトについてを読んでください、

90日で学ぶ AIとPython|完全初心者から「作れる」までDay9:コメントを書いてみよう(未来の自分を助ける)

Tensui
Tensui

このシリーズでは
Windows / Mac のどちらでも使える
「Python + VS Code」環境で進めます。

ChatGPTは
・コードを考えてもらう
・エラーを相談する
ための“相棒”として使います。

※ ChatGPT上でコードを実行することはできません。
必ず自分のPCで実行してください。


 


Day9:コメントを書いてみよう(未来の自分を助ける)

プログラムを書いていて、
数日後にこうなったことありません?

「……これ、何のコードだっけ?」
「書いたのは俺だけど、意味わからん」

これ、プログラマーあるあるです。

それを防ぐのが👇

コメント(説明文)

今日は
未来の自分を助ける技術を身につけます。


✍ コメントってなに?

コメントは👇

プログラムの動きには関係しない
“メモ書き”

Pythonでは
# から右側がコメントになります。

# これはコメントです
print(“こんにちは") # ここもコメント

実行結果👇

こんにちは

👉 コメントは無視されて、
プログラムは普通に動きます。


🧠 なんでコメントが必要?

理由は3つ。

① 未来の自分が忘れる

1週間後の自分は、
ほぼ他人です。

👉
「何のためのコード?」
を毎回思い出すのはしんどい。


② 途中でやめたときに助かる

  • 体調不良

  • 眠い

  • 今日はやめる

👉
コメントがあると
再開がラク


③ 人に見せるときに優しい

  • ブログに載せる

  • 誰かに見せる

  • 将来の自分に見せる

👉
コメントがあるだけで
**“やさしいコード”**になる。


🧪 実際にコメントを書いてみよう

# 2つの数字を足し算する
a = 10
b = 3
# 結果を表示する
print(a + b)

👉
後から見ても
「何してるか一瞬で分かる」


❌ 悪いコメント例

a = 10 # aに10を入れる

👉 これは意味がない。

⭕ 良いコメント例

# 年齢を保存する
age = 10

👉
「なぜこの変数があるのか」
を書くと価値が出る。


📝 1行コメント / まとめコメント

# ユーザーの年齢を入力して、10年後の年齢を表示する
age = 20
future_age = age + 10
print(future_age)

👉
最初に
このプログラムの目的を書いておくと最高。


😇 コメントのコツ

✔ 「何をしているか」より
✔ 「なぜそうしているか」を書く
✔ 日本語でOK
✔ 自分が分かればOK


✅ 今日できるようになったこと

✔ コメントの意味が分かった
# の使い方が分かった
✔ 未来の自分に優しくなれた


☕ 1分まとめ

  • Tensui
    Tensui

    • # から右はコメント

    • コメントは実行されない

    • 未来の自分を助けるメモ

    • 「なぜそうしたか」を書く

    • 日本語でOK


    👉 次回 Day10:入力を受け取るプログラムを作ろう
    ついに
    「人とやり取りするプログラム」
    を作ります。

よかったら応援してください

AIとPythonAIとPython

Posted by mon1127