TypeError: can only concatenate str (not "int") to str
Încerci să lipești cu `+` un text (str) cu un număr (int). Python nu transformă singur numărul în text. Folosește un f-string (`f"Total: {total}"`), `str(total)` sau dă valorile separat lui `print`, cu virgulă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Operatorul + face lucruri diferite în funcție de tip: între numere adună, între texte le lipește (concatenează). Când în stânga e un text, Python se așteaptă ca și în dreapta să fie tot un text.
Mesajul se citește așa: can only concatenate str (pot lipi doar texte) (not "int") (nu un număr întreg) to str (la un text). În paranteză poate apărea și alt tip: "float", "list", "NoneType". Linia din eroare îți arată unde e +-ul problemă. Cel mai des apare la construirea unui mesaj: "Ai " + varsta + " ani". Python nu face conversii automate de tip, tocmai ca să nu ascundă greșeli: trebuie să alegi tu explicit ce vrei.
De ce apare: cauzele frecvente
1Mesaj construit cu + și un număr
varsta = 25
print("Ai " + varsta + " ani")varsta = 25
print(f"Ai {varsta} ani")În f-string, {varsta} e transformat automat în text. Cu +, ar trebui să scrii str(varsta).
2Un rezultat numeric lipit de un text
total = 12.5 * 2
mesaj = "Total: " + totaltotal = 12.5 * 2
mesaj = "Total: " + str(total)total e un float. str(total) îl transformă în text, iar + între două texte funcționează (mesajul ar fi can only concatenate str (not "float") to str).
3Text și număr date separat lui print
puncte = 80
print("Scor: " + puncte)puncte = 80
print("Scor:", puncte)Cu virgulă, print primește două valori și le afișează separat, fără să le lipească el însuși.
Repară eroarea, direct în pagină
Codul de mai jos dă TypeError: can only concatenate str (not "int") to str. Repară-l ca să afișeze Ana are 3 produse în coș, total 87 lei.
nume = "Ana"
produse = 3
total = 87
print(nume + " are " + produse + " produse în coș, total " + total + " lei")Ana are 3 produse în coș, total 87 lei
Indiciu
Folosește un f-string sau transformă numerele în text cu str().
Reparația
nume = "Ana"
produse = 3
total = 87
print(f"{nume} are {produse} produse în coș, total {total} lei")De ce merge
Operatorul + lipește doar texte cu texte, iar produse și total sunt numere întregi, de aceea Python s-a oprit la primul + dintre text și produse. Un f-string rezolvă totul dintr-o dată: tot ce scrii între acolade e calculat și transformat automat în text, iar codul devine și mai ușor de citit decât varianta cu multe + și str().
Alte forme ale mesajului
TypeError: can only concatenate str (not "float") to strTypeError: can only concatenate str (not "NoneType") to strTypeError: can only concatenate list (not "int") to list
Cum o eviți pe viitor
- Folosește f-string-uri pentru orice mesaj care combină text cu valori:
f"{nume} are {varsta} ani". - Dacă folosești
+, transformă explicit valorile custr(...). - Când vezi
(not "NoneType"), problema e alta: valoarea eNone, de obicei o funcție care nu returnează nimic.
Întrebări frecvente
De ce Python nu transformă automat numărul în text, ca JavaScript?
Python are tipuri stricte la operații: nu ghicește dacă "5" + 3 ar trebui să dea "53" sau 8. Te obligă să alegi tu explicit, cu str(3) sau int("5"), ca să eviți rezultate surprinzătoare.
Și dacă vreau să adun un număr citit ca text?
Atunci transformă textul în număr: int("5") + 3 dă 8. Pentru zecimale folosește float("5.5").
Erori înrudite
TypeError: unsupported operand type(s) for +: 'int' and 'str' Faci o operație aritmetică între un număr și un text, de exemplu `10 + "5"` sau `sum()` peste o listă de texte. De obicei valoarea vine dintr-o citire și e încă text: transform-o cu `int()` sau `float()` înainte de calcul. ValueError: invalid literal for int() with base 10: 'abc' `int()` a primit un text care nu este un număr întreg: litere, un text gol, spații în interior sau un număr cu zecimale (`'3.5'`). Curăță textul (`strip()`, `replace(',', '.')`), folosește `float()` pentru zecimale și prinde valorile invalide cu `try/except ValueError`. TypeError: sequence item 0: expected str instance, int found Ai folosit `"separator".join(lista)` pe o listă care conține numere. `join` unește doar texte: transformă elementele în text, de exemplu `", ".join(str(x) for x in lista)` sau `", ".join(map(str, lista))`. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
