【Python自學】python常見的命名法，駝峰式命名法以及蛇行命名法
📘 Python 變數命名規則：camelCase 與 snake_case
這個禮拜和老婆去日本玩，拍了許多精美的照片。
回來後當然得好好保存。於是打開電腦、插上硬碟、打開資料夾，最後把照片都丟進去。
全部整理好之後，問題來了：這個資料夾名稱你會怎麼命名？
- 2025年日本遊（與老婆）
- 2025_日本遊_七天六夜
- 12314
- jfoipdjfgdsijutp
顯然，命名是一門學問。否則你就不會看到許多男性朋友的桌面資料夾名稱，常常是第 3 或第 4 種命名方法。
因為程式碼通常不是寫完就結束，它很可能會被你自己、同事、未來接手的人重新閱讀與修改。
🧭 Python 常見命名方式
在寫程式時，變數名稱通常會使用有意義的英文單字，並依照固定規則組合。
常見的命名方式主要有這幾種：
- 小駝峰式命名法：camelCase
- 蛇行命名法：snake_case
- 大駝峰式命名法：PascalCase
🐫 小駝峰式命名法：camelCase
小駝峰式命名法的規則是：
- 第一個單字全部小寫。
- 後面每個單字的第一個字母大寫。
- 單字中間不使用底線。
camelCase 範例
小駝峰常見於 Java、JavaScript 等語言，也常用在變數名稱與函式名稱。
為什麼叫「駝峰」也很好理解。因為後面單字的大寫字母，看起來就像駱駝背上的峰。
🐍 蛇行命名法：snake_case
蛇行命名法的規則是：
- 所有英文字母全部小寫。
- 單字之間使用底線 _ 連接。
- 可讀性高，容易分辨單字。
snake_case 範例
在 Python 中，snake_case 是官方推薦用於「變數名稱」與「函式名稱」的命名方式。
為什麼叫蛇行命名法也很好理解。因為一條又一條的底線，看起來就像蛇慢慢爬過去。
🏛️ 大駝峰式命名法：PascalCase
除了小駝峰與蛇行命名法，還有一種常見命名方式叫做大駝峰式命名法，也稱為 PascalCase。
它的規則是：
- 每個單字的第一個字母都大寫。
- 單字中間不使用底線。
- Python 中常用於類別名稱。
PascalCase 範例
如果是 Python 類別名稱，通常會使用 PascalCase。
📋 命名方式比較表
以下用表格整理三種常見命名方式的差異。
| 命名方式 | 寫法 | 常見用途 | 範例 |
|---|---|---|---|
| 小駝峰式 | camelCase | JavaScript、Java 常見 | totalPrice |
| 蛇行命名法 | snake_case | Python 變數、函式 | total_price |
| 大駝峰式 | PascalCase | Python 類別名稱 | UserProfile |
💡 為什麼要規定命名方式？
最主要的原因是：程式碼的可讀性。
有時候程式寫完之後，不是只有你會進到後台修改。接下你專案的工程師、合作夥伴，甚至是客戶，都可能需要閱讀你的程式碼。
如果命名清楚，別人就能比較快理解你的程式在做什麼。
不好的命名
這段程式雖然可以執行，但光看變數名稱，很難知道它在算什麼。
比較好的命名
這樣一看就知道：單價是 price，數量是 quantity，總價是 total_price。
三個月後回來看自己寫的程式，你會感謝今天有好好命名的自己。
📐 PEP 8：Python 官方程式碼風格指南
說到 Python 命名規範，就會提到 PEP 8。
PEP 8 是 Python 官方的程式碼風格指南，用來規範程式碼要怎麼寫，才會整齊、好讀、容易維護。
PEP 8 核心重點
- 縮排：使用 4 個空白，不建議使用 Tab。
- 每行長度：建議每行不要超過 79 個字元。
- 變數命名：使用 snake_case，例如 total_score。
- 函式命名：使用 snake_case，例如 calculate_total。
- 類別命名：使用 PascalCase，例如 UserProfile。
- 空行：函式之間適當空行；類別之間通常空兩行。
- 運算子前後：建議加上空白，例如 total = price * quantity。
PEP 8 寫法範例
如果你使用 PyCharm、VS Code 這類開發工具，它們通常會自動提示你哪些地方不符合 PEP 8，甚至可以幫你格式化程式碼。
畢竟工具可以幫你排版，不能幫你把 abc123 變成有意義的變數名稱。
🧪 命名練習
下面是幾個命名練習，試著把中文意思轉成 Python 推薦的 snake_case。
| 中文意思 | 推薦命名 |
|---|---|
| 使用者名稱 | user_name |
| 使用者年齡 | user_age |
| 總金額 | total_price |
| 學生分數 | student_score |
| 日本旅遊照片 | japan_trip_photos |
| 與老婆日本旅遊 | japan_trip_with_wife |
✅ 小結
Python 的命名規則看起來只是格式問題，但其實是寫出可讀、好維護程式碼的重要基礎。
- camelCase：第一個單字小寫，後面單字首字母大寫，例如 totalPrice。
- snake_case：全部小寫，用底線連接，例如 total_price。
- PascalCase：每個單字首字母大寫，例如 UserProfile。
- Python 變數與函式：推薦使用 snake_case。
- Python 類別：推薦使用 PascalCase。
- PEP 8：Python 官方程式碼風格指南，幫助程式碼更一致、更好讀。
好的命名，就是寫給未來的自己和別人看的說明書。
留言
張貼留言