Python 是一種極受歡迎的編程語言，它不僅易于學習也有廣泛的用途。在 Python 中，注釋是一種用于增強代碼可讀性和可理解性的重要元素。事實上，Python 提供了一種簡單而有效的方法來生成注釋。

# 生成文檔注釋
def my_function():
"""這是一個文檔字符串的函數示例
這個函數不執行任何操作，只是返回一個字符串。
該字符串包含程序的用途和簡要說明。
Returns:
str: 包含程序用途和簡要說明的字符串。
"""
return "這是一個函數示例"
print(my_function.__doc__)

在上面的示例中，我們使用三重引號來創建一個文檔字符串，這個字符串包含了程序的用途和簡要說明。在函數下方，我們使用一個字符串字面量來訪問函數的文檔字符串并將其打印到控制臺。

在 Python 中，文檔字符串也稱為 “docstrings”，它們與函數、類和模塊相關聯。Python 的內置函數和第三方庫通常都含有文檔字符串，這些文檔字符串被用于自動生成文檔和幫助文檔。

Python 的注釋還支持內聯注釋和模塊注釋。內聯注釋是將注釋放在代碼行的末尾，而模塊注釋是將注釋放在模塊的開頭。

# 內聯注釋
x = 5  # 將變量 x 賦值為 5
print(x)
# 模塊注釋
"""
這是一個模塊注釋，它是這個模塊的開頭。
"""
def my_function():
# 一個內聯注釋
return "這是一個函數示例"

無論是使用文檔字符串來生成文檔還是為代碼添加注釋，注釋都是編寫維護可讀性高的 Python 代碼的重要工具。通過使用 Python 的注釋功能，您可以輕松地使您的代碼更加可讀，易于理解和維護。