Python文、インデント、コメント入門

このチュートリアルでは、クリーンで効率的で保守しやすいコードを書く上で非常に重要な、Pythonの文、インデント、コメントの基本的な理解を提供します。

目次

1. Pythonの文
2. Pythonのインデント
3. Pythonのコメント

Pythonの文

Pythonにおいて、文とはインタプリタによって実行される単一の命令です。通常は1行を占めますが、長い文は行継続（バックスラッシュまたは括弧()）を使って複数行にまたがることもあります。文には、代入、関数呼び出し、ループ、条件文が含まれます。

例：

• 代入：x = 10（xに10を代入）
• 関数呼び出し：print("Hello!")
• 条件文：

  
  if x > 5:
      print("xは5より大きいです")
  else:
      print("xは5より大きくありません")
  

• ループ文：

  
  for i in range(5):
      print(i)
  

Pythonのインデント

中括弧{}を使ってコードブロックを定義する言語とは異なり、Pythonはインデントを使用します。これは、ブロック（if、else、for、while、関数、クラス）内の文のグループ化を決定します。一貫したインデントは必須であり、不一致はIndentationErrorを引き起こします。

正しいインデント：

if x > 5:
    print("xは5より大きいです")
    y = x * 2
else:
    print("xは5より大きくありません")

間違ったインデント：

if x > 5:
print("xは5より大きいです")  # IndentationError
y = x * 2
else:
print("xは5より大きくありません") # IndentationError

インデントには4つのスペースを使用してください。タブは避けてください。

Pythonのコメント

コメントは、インタプリタによって無視される説明的なメモです。これらは、コードの可読性と理解を向上させます。Pythonには2つの種類があります。

• 単一行コメント：#で始まります。同じ行の#以降はすべてコメントになります。
• 複数行コメント（docstring）：三重引用符（'''または"""）で囲まれています。関数、クラス、モジュールのドキュメント化によく使用されます。

例：

x = 10  # 単一行コメント

'''
これは
複数行コメントです。
'''

def my_function():
    """これはdocstringです。"""
    pass

効果的なコメントは、クリーンで保守しやすいコードにとって非常に重要です。コメントは簡潔で関連性の高いものにし、冗長な説明は避けてください。