コメントの書きすぎ
次のようなコメントについての考え方として、最も適切なものを1つ選べ。
「x = x + 1 # x に 1 を足す」
- A
コードを読めば分かることを繰り返しているので、不要である。なぜそうするのかが分からない部分に、理由を書く。
- B
すべての行に、このようなコメントを付けるのが望ましい。
- C
コメントは、コードの内容を日本語に翻訳したものを書く。
- D
コメントがあるほど、品質が高い。
正解と解説を見る
正解:A
コメントは、コードから分からないこと(理由、背景、注意点)を書く。コードの繰り返しは、読み手の邪魔になり、コードと食い違ったときに混乱する。
| 種類 | 規則 |
|---|---|
| ブロックコメント | 直後のコードと同じ深さで、行頭は「# 」(シャープと空白) |
| インラインコメント | コードの後ろに空白2つ以上を空けて「# 」。控えめに使う |
| 内容 | コードを言い換えるだけのコメントは書かない。理由や意図を書く。コードと食い違ったら更新する |
| 言語・文 | 読み手が通じる言語で、完全な文で書く |
| コメントアウトされたコード | 残さない(バージョン管理を使う) |
- A
正しい。自明なコメントは、ノイズになる。
- B
誤り。コードの繰り返しは、不要。
- C
誤り。理由や意図を書く。
- D
誤り。量ではなく、質。
このサイトの問題は、各試験の公式に示された出題範囲に沿って作ったオリジナルの模擬問題です。本試験の問題ではありません。一般社団法人Pythonエンジニア育成推進協会の公式サービスではありません。