輸出與註解

Print 函式與註解

學習目標

  • 掌握 print() 函式的基本與進階用法。
  • 學會使用 sepend 參數客製化輸出格式。
  • 理解註解的重要性,並學會撰寫單行與多行註解。
  • 培養良好的註解習慣,提升程式碼的可讀性與可維護性。

第 1 章:程式的發聲筒 - print() 函式

print() 是 Python 中最基本也最重要的內建函式之一。它就像是程式的「發聲筒」,讓我們能夠將文字、變數的值或任何運算結果顯示在螢幕上,是除錯和觀察程式狀態不可或缺的工具。

1.1 基本用法

print() 的最基本用法是將你想顯示的內容放在括號 () 中。

# 1. 印出字串 (文字需用引號包起來)
print("Hello, World!")

# 2. 印出數字 (數字不需引號)
print(123.45)

# 3. 印出變數的內容
student_name = "小明"
print(student_name)

1.2 一次印出多個項目

你可以在 print() 中放入多個項目,用逗號 , 隔開。預設情況下,它們之間會自動用一個空格隔開。

item = "蘋果"
price = 50
quantity = 3
print(item, "單價:", price, "數量:", quantity)

輸出結果:蘋果 單價: 50 數量: 3

1.3 sep 參數:自訂分隔符號

如果你不想要預設的空格,可以使用 sep (separator) 參數來指定你想要的分隔符號。

# 使用 "---" 作為分隔符號
print("臺北", "臺中", "高雄", sep="---")

# 使用 "/" 組合日期
print(2025, 10, 1, sep="/")

輸出結果:

臺北---臺中---高雄
2025/10/1

1.4 end 參數:自訂結尾字元

預設情況下,每次呼叫 print() 後,游標都會自動換到下一行,這是因為它內建了 end='\n' (\n 是換行符號)。我們可以修改 end 參數來改變這個行為。

# 範例 1: 讓兩次 print 的結果連在一起
print("處理中,請稍候", end="") # 結尾不加任何東西
print("...")

# 範例 2: 使用自訂符號連接
print("第一部分", end=" -> ")
print("第二部分")

輸出結果:

處理中,請稍候...
第一部分 -> 第二部分

第 2 章:給人類看的筆記 - 註解

註解是程式碼中非常重要的一部分,但它完全是寫給人類看的。Python 直譯器在執行程式時會完全忽略所有註解。

2.1 為什麼要寫註解?

  • 解釋邏輯:說明一段複雜的程式碼是如何運作的,或是為什麼要這麼寫。
  • 留下備忘:為未來的自己或同事留下提醒,例如 # TODO: 這裡的錯誤處理還不夠完善
  • 暫時停用程式碼:在除錯時,可以先將某行或某幾行程式碼「註解掉」,讓它暫時不執行,方便找出問題。

2.2 單行註解 (#)

在 Python 中,任何以井字號 # 開始的文字,從 # 到該行結尾都屬於註解。

# 這是一整行的註解,用來說明底下程式碼的功能。
TAX_RATE = 0.05  # 這是在程式碼後方的「行內註解」,用來解釋這個變數的用途。

price = 100
total_price = price * (1 + TAX_RATE) # 計算含稅價格

# print(price)  # 這行被註解掉了,所以不會被執行
print(total_price)

2.3 多行註解

Python 並沒有像其他語言一樣有特定的多行註解語法,但有兩種常見的作法:

1. 官方推薦作法:使用多個 #

最標準、最清晰的作法是在每一行前面都加上 #

# 這是多行註解的第一行。
# 它可以詳細解釋一個函式或演算法的複雜邏輯。
# 每一行都以 # 開頭。

2. 常用作法:使用多行字串

你可以使用三個雙引號 """ 或三個單引號 ''' 來建立一個多行字串。雖然這在技術上是一個「字串」,但如果沒有將它賦值給任何變數,Python 直譯器會忽略它,因此它達到了類似多行註解的效果。這種形式也常被用作「文件字串 (Docstrings)」。

"""
這是一個多行字串,
常被開發者用來當作多行註解使用。
它特別適合用來寫大段的說明文字。
"""
def calculate_area(radius):
    '''這就是文件字串(Docstring),用來解釋函式功能。'''
    return 3.14 * radius ** 2

2.4 註解的好習慣

一個好的註解,應該是解釋「為什麼」,而不是「做什麼」。
  • 保持註解與程式碼同步更新。
  • 使用註解來規劃你的程式碼結構。

總結

  • print() 是你學習 Python 過程中最重要的朋友,善用它來觀察程式的每一步。
  • 使用 sepend 可以讓你的輸出更加靈活與美觀。
  • 註解 (#) 是程式碼的說明書,為自己和他人而寫,是專業開發的必備習慣。
  • 從今天開始,為你的程式碼加上有意義的註解,並用 print() 驗證你的每一步想法!

留言

這個網誌中的熱門文章

目錄

Python IDLE 安裝與使用

Python 核心資料型態:數字、文字與邏輯