...
Eroare Python pentru analiza datelor · Citirea fișierelor CSV

ValueError: Usecols do not match columns, columns expected but not found: ['pret']

Pe scurt

Ai cerut la read_csv, prin usecols, o coloană care nu există în antetul fișierului (aici 'pret'). Afișează antetul real (citește fișierul fără usecols și uită-te la df.columns) și scrie în usecols numele exacte, cu aceleași majuscule, spații și diacritice.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

usecols îi spune lui read_csv să păstreze doar anumite coloane. Înainte să citească datele, pandas compară lista ta cu antetul fișierului, iar dacă un nume nu apare acolo, oprește citirea: „columns expected but not found: ['pret']” = coloanele pe care le-ai cerut și nu le-a găsit.

Cauzele sunt aceleași ca la KeyError pe coloană: alt nume în fișier (Pret, pret_unitar, preț), un spațiu după virgula din antet (produs, pret), un separator diferit (;) din cauza căruia tot antetul e o singură coloană.

Dacă dai în usecols poziții ([0, 5]) în loc de nume și o poziție nu există, mesajul e altul: Defining usecols with out-of-bounds indices is not allowed.

De ce apare: cauzele frecvente

1Numele din fișier e diferit

Greșit
PYTHON
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# antetul este: produs,pret_unitar,stoc
Corect
PYTHON
df = pd.read_csv("produse.csv", usecols=["produs", "pret_unitar"])

usecols trebuie să folosească exact numele din antetul fișierului.

2Separator nespecificat

Greșit
PYTHON
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# fișierul folosește ;
Corect
PYTHON
df = pd.read_csv("produse.csv", sep=";", usecols=["produs", "pret"])

Fără sep=";", antetul e citit ca o singură coloană, produs;pret, și niciun nume cerut nu există.

3Spații după virgulă în antet

Greșit
PYTHON
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# antetul este: produs, pret
Corect
PYTHON
df = pd.read_csv("produse.csv", skipinitialspace=True, usecols=["produs", "pret"])

skipinitialspace=True ignoră spațiile de după separator, deci coloana se numește pret, nu ' pret'.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă ValueError: Usecols do not match columns. Fișierul produse.csv există, dar coloana cu prețul are alt nume. Repară usecols ca să citească produsul și prețul, apoi afișează coloanele citite și prețul mediu.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.read_csv("produse.csv", usecols=["produs", "pret"])

print(df.columns.tolist())
print("Preț mediu:", round(df.iloc[:, 1].mean(), 2))
După reparație, programul afișează
['produs', 'pret_unitar']
Preț mediu: 22.8
Indiciu

Antetul fișierului este produs,pret_unitar,stoc.

Alte forme ale mesajului

  • ValueError: Usecols do not match columns, columns expected but not found: ['Pret', 'data']
  • pandas.errors.ParserError: Defining usecols with out-of-bounds indices is not allowed. [5] are out of bounds.

Cum o eviți pe viitor

  • Citește întâi fișierul fără usecols (sau doar antetul, cu nrows=0) și afișează df.columns.tolist().
  • Copiază numele coloanelor din antet, nu le scrie din memorie.
  • Pentru nume care se schimbă de la un export la altul, poți da o funcție: usecols=lambda c: c.strip().lower() in {"produs", "pret"}.
  • Stabilește separatorul înainte de orice altceva.

Întrebări frecvente

Cum văd doar antetul unui fișier mare?

pd.read_csv("fisier.csv", nrows=0).columns.tolist() citește doar prima linie și îți dă lista exactă a coloanelor, fără să încarce datele.

Pot da în usecols numere în loc de nume?

Da: usecols=[0, 2] păstrează prima și a treia coloană. E util când numele sunt instabile, dar fragil dacă ordinea coloanelor se schimbă în fișier.

Erori înrudite

← Toate erorile Python pentru analiza datelor

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție

Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.