HOWTO · Python
修復 Python 中的 TypeError: must be str, not int
瞭解如何修復 Python 中的 must be str not int 錯誤
本頁內容
TypeError: must be str, not int 表示某個操作預期收到文字,卻收到整數。常見原因是使用 + 串接:Python 允許兩個運算元都是字串時進行串接,但不會自動將數字轉成文字。例如,"Count: " + 3 會引發這個錯誤。浮點數、布林值或其他非字串值也可能造成相同問題。
這個錯誤反映的是操作中運算元的型別,不代表整數本身是否合理。修改值之前,先判斷你要的是文字還是算術運算。如果這個值之後還要用於比較、加法或其他計算,就讓它維持數值型別,只在顯示時再格式化。
Python 為何會引發 TypeError: must be str, not int
+ 運算子會依運算元的型別執行數字相加或字串串接。當一個運算元是字串、另一個是整數時,Python 無法判斷你是想把數字接在字串後面,還是要進行數值計算。因此,它會指出型別不相符,而不會自行選擇轉換方式。
以下精簡範例會捕捉失敗的操作,讓程式能繼續執行,接著印出產生的錯誤訊息。範例程式碼、標籤與輸出保留英文:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
try:
result = "Count: " + 3
except TypeError as error:
message = f"{type(error).__name__}: {error}"
print(message)
TypeError: can only concatenate str (not "int") to str
若要產生預期的文字,請先轉換整數。修正後的運算式是 "Count: " + str(3),結果為 Count: 3。
內建的 join() 有一項相關規則:它的輸入可迭代物件必須包含字串,不會替你轉換整數。當你已有文字片段時適合使用它;若需要的是值的文字表示,請明確轉換該值。
串接字串前先檢查值
找出將文字與其他值組合的運算式,接著在該運算式執行前,逐一檢查每個運算元。type(value).__name__ 可指出值在執行時的型別;印出或檢視值則有助於確認其內容。執行以下範例。範例程式碼、標籤與輸出保留英文:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
label = "Order"
number = 1923
print(f"{label} #{number}")
範例會印出:
Order #1923
若要診斷混合型別的運算式,請在串接前印出兩個運算元的值和型別。以下範例會捕捉例外,接著連同診斷資訊一起印出錯誤訊息。範例程式碼、標籤與輸出保留英文:
label = "Count: "
count = 3
print(f"left={label!r} ({type(label).__name__})")
print(f"right={count!r} ({type(count).__name__})")
try:
message = label + count
except TypeError as error:
error_message = f"{type(error).__name__}: {error}"
print(error_message)
left='Count: ' (str)
right=3 (int)
TypeError: can only concatenate str (not "int") to str
left 那一行顯示型別為 str、值為 'Count: ';right 則顯示型別為 int、值為 3。這個整數就是無法直接與字串串接的運算元。最後一行顯示產生的 TypeError 訊息。
遇到失敗的運算式時,請檢查 + 兩側,而不是改動程式周圍的所有值。變數名稱可能掩蓋了非字串的值;從輸入、檔案或 API 讀取的值,型別也可能與預期不同。錯誤中提到的 int 表示其中一個運算元是整數,但檢查運算式才能找出是哪個變數提供了它。
預期結果是文字時,使用 str() 轉換值
當結果應該是文字時,例如報表標籤或訊息,請呼叫 str(value)。這個函式會傳回字串表示;轉換後的結果不會保留原始型別。若只是為了顯示,這種做法很實用;但如果後續程式碼需要將該值當作數字相加、比較或進行其他處理,就不適合這樣轉換。範例程式碼、標籤與輸出保留英文。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
count = 1923
message = "Count: " + str(count)
print(message)
Count: 1923
對清單和其他物件而言,str() 產生的是供人閱讀的表示方式,不是保證適合儲存或交換資料的序列化格式。若自訂物件定義了 __str__() 方法,物件表示會使用該方法;否則 Python 會採用一般表示方式作為後備。不要假設轉換結果一定是潤飾過的句子,或能讓其他程式安全解析的格式。
使用 f 字串組合文字和值
組合固定文字與值來建立訊息時,f 字串通常是最清楚的選擇。在字串前加上 f,並將運算式放在大括號內。Python 會將各值格式化為字串,因此一般顯示用途不必另外呼叫 str()。範例程式碼、標籤與輸出保留英文。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
count = 1923
price = 12.5
message = f"Count: {count}; price: {price}"
print(message)
Count: 1923; price: 12.5
大括號內的運算式會在格式化時求值。請讓運算式保持簡單易讀;較複雜的值可先存入具名變數。和 str() 一樣,格式化會產生文字;若程式仍需要數值運算,就保留原本的數值變數。
依資料用途選擇合適的修正方式
若預期結果是訊息,請使用 str() 或 f 字串。要組合多個帶標籤的值時,優先使用 f 字串;若較大的操作中有一部分需要字串轉換,則使用 str()。若要進行數學加法,請將值轉換或驗證為數字,不要把數字接在文字後面。
使用 join() 時,只有在預期結果是文字清單的情況下,才明確轉換每個元素。生成器運算式可以完成轉換,而不必建立中間清單。範例程式碼、標籤與輸出保留英文:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
values = [1923, 12, 5]
text = ", ".join(str(value) for value in values)
print(text)
這會在串接之前,將每個元素轉換成供顯示的表示方式。如果元素應維持數值型別,請先完成數值運算,再格式化最後結果。了解這些差異,才能依資料用途選擇修正方式,而不是掩蓋型別不相符的問題。