1. Python 的註解基礎與其重要性
在 Python 中使用註解是一項重要的工具，有助於讓其他人或自己日後能更容易理解程式碼。透過加入說明或備註，可以提升程式的可維護性，讓錯誤排查與邏輯說明更順利。此外，在開發過程中也能暫時停用特定程式碼進行測試，非常實用。
1.1 單行註解的基本用法
Python 中的單行註解使用「#」。只要在行首加上「#」，整行就會被視為註解。
# 這是一行註解
print("Hello, World!") # 這部分也是註解
如上所示，可以加入說明性文字或未來修改時有幫助的註解內容。1.2 多行註解的基本概念
要註解多行程式碼，最常見的方法是為每一行個別加上「#」。雖然這需要手動為每行插入符號，但在停用大段程式碼時非常有效。
# 這是第一行註解
# 這是第二行註解
# 這是第三行註解為了節省多行註解的時間，還有一些更高效率的方法，我們將在後面介紹。
2. 在 Python 中註解多行程式碼的兩種方法
要註解多行程式碼，有幾種實用的技巧。以下介紹兩種常見的方法。
2.1 使用「#」進行多行註解
用「#」來註解多行程式碼是最簡單且普遍的方法。
# 這是第一行註解
# 這是第二行註解
# 這是第三行註解不過，當註解的行數過多時會比較麻煩，因此這種方法比較適合小範圍的程式區塊。
2.2 使用三重引號進行多行註解
在 Python 中，可以連續使用三個單引號（”’）或三個雙引號（”””）來達成多行註解。雖然這原本是用來撰寫文件字串（docstring），但也可作為註解的替代方式。
"""
這裡是多行註解
可以跨多行停用程式碼
"""不過要注意的是，這種方式會被當作字串處理，因此嚴格來說不是真正的註解。若在大型專案中頻繁使用，可能會增加不必要的記憶體消耗，因此需視情況使用。
3. Python 註解時常見的錯誤與避免方法
在進行註解時，有幾個需要特別注意的重點。尤其是在縮排錯誤與三重引號的使用方式上，要格外謹慎。
3.1 避免縮排錯誤
Python 對於縮排有嚴格規定，如果縮排不正確，就會發生 IndentationError。即使使用三重引號來進行註解，若縮排混亂也可能導致意料之外的錯誤。
def example():
"""
這裡是註解
"""
print("Hello, World!") # 此處將發生縮排錯誤在 Python 中，保持縮排一致性是非常重要的。
3.2 使用三重引號可能造成資源消耗
使用三重引號進行註解時，Python 解譯器會將其視為字串處理，進而消耗記憶體。因此在處理大型程式碼區塊時，不建議頻繁使用此方法。這種方式較適合用於真正的說明文件（docstring），而非純粹註解用途。
4. 使用快捷鍵高效率註解程式碼
許多編輯器與整合式開發環境（IDE）都提供快捷鍵，可瞬間註解多行程式碼。以下是幾個常見編輯器的快捷鍵說明：
Visual Studio Code：Windows 為 Ctrl + /，Mac 為 Cmd + /
PyCharm：Windows 為 Ctrl + /，Mac 為 Cmd + /
Sublime Text：Windows 為 Ctrl + /，Mac 為 Cmd + /
善用這些快捷鍵，可以大幅提升註解作業的效率，節省開發時間。例如選取多行後直接使用快捷鍵，就能一鍵註解，在除錯或測試時特別方便。
5. 總結
本文介紹了在 Python 中註解多行程式碼的各種方法。從使用「#」的基本單行註解，到利用三重引號的多行註解，再到透過快捷鍵提高效率的技巧，全面涵蓋了實用的註解方法。
在 Python 的開發工作中，註解是提升程式碼可讀性與可維護性不可或缺的工具。透過適當的註解方式，不僅能提升整個專案的品質，也能加強團隊成員之間的理解與協作。請善用這些技巧，讓你的 Python 開發效率更上一層樓。