Python 基本語法與註解

Python 基本語法(Python Basic Syntax)

這篇 Python 語法教學將帶你認識 Python 最基本的程式結構:縮排規則、註解寫法與程式執行方式。Python 與多數語言最大的不同在於——縮排就是語法,不是排版美觀問題,寫錯縮排程式會直接報錯。先把這些規則弄清楚,後面的學習會順利很多。

Python 基本語法規則總覽:

規則說明
縮排表示區塊同一層級的程式碼縮排必須一致,慣例使用 4 個空格
不需要分號一行就是一個敘述,行尾不用加分號
大小寫敏感nameName 是兩個不同的變數
冒號開啟區塊iffordef 等語句結尾要加冒號 :,下一行開始縮排
註解用 ## 之後到行尾的文字不會被執行

縮排(Indentation)

Python 用縮排決定程式碼屬於哪個區塊。以下是正確的寫法:

age = 20
if age >= 18:
    print("已成年")      # 這行縮排 4 格,屬於 if 區塊
    print("可以投票")    # 同區塊,縮排必須一致
print("檢查結束")        # 沒有縮排,不屬於 if 區塊

執行輸出:

已成年
可以投票
檢查結束

如果縮排不一致,Python 會直接報錯:

if age >= 18:
    print("已成年")
      print("可以投票")   # 縮排多了 2 格,報錯

執行輸出:

IndentationError: unexpected indent

註解(Comments)

註解是寫給人看的說明文字,執行時會被忽略。單行註解使用 #

# 這是單行註解
price = 100  # 也可以寫在程式碼後面

多行說明慣例上使用三個引號的字串(docstring),常用於函式或檔案開頭的說明:

"""
這是多行字串,
常被當作多行註解或文件說明使用。
"""
print("Hello")

執行輸出:

Hello

一行一個敘述

Python 不需要分號結尾,一行就是一個敘述。若一行太長,可以用反斜線 \ 或括號換行:

total = 1 + 2 + 3 + \
        4 + 5 + 6

result = (1 + 2 + 3 +
          4 + 5 + 6)

print(total, result)

執行輸出:

21 21

常見錯誤

1. IndentationError: unexpected indent

同一個區塊的縮排不一致。檢查每一行開頭的空格數,同層級必須完全相同,建議統一用 4 個空格。

2. TabError: inconsistent use of tabs and spaces

同一份程式混用了 Tab 鍵與空白鍵縮排。在 VS Code 中可開啟「Render Whitespace」顯示空白字元找出混用處,並設定 Tab 鍵自動轉換為 4 個空格。

3. SyntaxError: invalid character(全形符號)

使用中文輸入法時不小心打出全形符號,例如 ()。Python 只接受半形符號,報錯訊息通常會指出該字元,切回英文輸入法重打即可。這是中文使用者最常見的錯誤之一。

總結

Python 語法的核心就三件事:縮排表示區塊(慣例 4 個空格)、# 寫註解、一行一個敘述不用分號。其中縮排是初學者最容易出錯的地方,養成統一用 4 個空格的習慣,可以避免絕大多數的語法錯誤。下一篇我們來學習 Python 變數。

延伸閱讀