1. 前言
Python 是一種廣受初學者與高級開發者歡迎的程式語言，且程式碼管理相對簡單。然而，在開發過程中，為了暫時停用部分程式碼或為其他開發者留下說明，「註解」的使用至關重要。特別是多行註解，更是在除錯與理解程式碼時不可或缺的技巧。
本篇文章將深入介紹 Python 中進行多行註解的多種方法，包括使用 # 的基本方式、三重引號（Triple Quotes）的應用，以及如何利用開發環境的快捷鍵來高效註解程式碼。我們將提供具體的程式碼範例，讓初學者也能輕鬆理解並加以應用。
2. Python 的基本註解方法
在 Python 中，最基本的註解方法是使用 # 符號。透過 #，可以將該行標記為註解，使其在執行時被忽略。這種方法簡單易懂，適合用來為程式碼添加說明，或暫時停用某些程式碼片段。
2.1 單行註解
在行首加上 # 符號，即可將該行註解掉，使其在執行時無效。
# 這是一行註解
print("Hello, World!") # 也可以在行內添加註解由於註解是以行為單位的，因此可以在任何位置添加註解，幫助理解程式碼的邏輯與用途。
2.2 多行註解
如果要註解多行程式碼，可以在每行前加上 #，這在除錯或暫時停用多行程式碼時非常實用。
# 這段程式碼將不會被執行
# 多行註解的示範
print("這行已被註解，將不會執行")
3. 多行註解的方法
在 Python 中，除了使用 # 來註解多行之外，還有其他更有效率的方法。例如，您可以使用快捷鍵來快速註解多行，或利用三重引號（Triple Quotes）來處理長段落的註解。
3.1 使用快捷鍵批量註解多行程式碼
在大多數開發環境（IDE）中，可以透過快捷鍵來一次性為多行程式碼添加 #。例如，在 Visual Studio Code 中，使用 Ctrl + / 可以快速註解或取消註解多行程式碼。
# 範例：選取多行程式碼後使用快捷鍵來註解
# a = 1
# b = 2
# c = a + b透過這種方式，您可以快速對多行程式碼進行註解，而無需逐行手動添加 #，提高開發效率。
3.2 使用三重引號進行多行註解
Python 還可以使用三重引號（Triple Quotes）來註解多行程式碼。雖然它本質上是字串（String Literal），但也可以作為註解來使用，特別適用於長段落的說明。
'''
這段程式碼將被註解，不會被執行
適用於多行註解
'''
print("這行將會執行")需要注意的是，三重引號的內容在技術上仍然是字串，而不是正式的註解。如果這部分字串沒有被賦值給變數，則 Python 會忽略它，不會影響程式執行。
4. 三重引號的使用範例與注意事項
使用三重引號（Triple Quotes）來註解時，需要特別注意縮排（Indentation）。如果縮排不正確，可能會導致語法錯誤（Syntax Error）。
4.1 正確的使用方式
當三重引號用於函式內部時，應確保與其他程式碼的縮排保持一致，例如：
def sample():
'''
這裡的內容將作為註解
需要確保縮排與函式內其他程式碼一致
'''
print("這行將會執行")4.2 可能導致錯誤的案例
如果三重引號的縮排與函式內部的其他程式碼不匹配，可能會產生 IndentationError（縮排錯誤）：
def sample():
'''
這段註解會導致錯誤
因為縮排不正確
'''
print("這行將會產生錯誤")因此，在使用三重引號作為註解時，請務必確保縮排符合 Python 的語法規則。
5. Python 開發環境中的註解快捷鍵
不同的開發環境（IDE）提供了快捷鍵來幫助開發者更快速地註解多行程式碼。以下是幾個常見的 Python 開發環境及其快捷鍵。
5.1 PyCharm
在 PyCharm 中，可以使用 Ctrl + / 來快速註解或取消註解選取的程式碼。
5.2 Visual Studio Code
在 Visual Studio Code 中，也可以使用 Ctrl + / 來快速註解多行程式碼。此外，對於區塊註解（Block Comment），可以使用 Shift + Alt + A 來一次性註解選取的程式碼。
5.3 Jupyter Notebook
在 Jupyter Notebook 中，可以使用 Ctrl + / 來快速註解選取的多行程式碼。對於數據科學家和機器學習工程師來說，這是一個非常實用的功能。
6. 註解的最佳實踐
適當地使用註解有助於提升程式碼的可讀性，使其更容易被理解。但過度的註解可能會適得其反。因此，良好的註解習慣至關重要。
6.1 適當的註解方式
註解應該用來解釋程式碼的目的，而不是重複描述程式碼本身。例如，以下是一個良好的註解範例：
# 接受兩個參數 a 和 b，並返回它們的總和
def add(a, b):
return a + b6.2 避免過度註解
過多的註解會讓程式碼變得雜亂無章，影響可讀性。例如，以下是不必要的註解範例：
# 將 1 指派給變數 a
a = 1
# 將 2 指派給變數 b
b = 2
# 將 a 和 b 相加並存入變數 c
c = a + b這類註解幾乎沒有額外的資訊價值，應該避免使用。
7. 總結
在 Python 中，有多種方式可以進行多行註解，例如使用 #、三重引號（Triple Quotes），或是利用開發環境的快捷鍵來提高效率。其中，# 是最直觀且普遍適用的方法，而三重引號則適用於長段落的註解。此外，掌握 IDE 的快捷鍵可以讓程式開發更加順暢。
希望本指南能幫助您更有效地使用 Python 註解技術，提升開發效率！