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

ValueError: Excel file format cannot be determined, you must specify an engine manually.

Pe scurt

pd.read_excel a deschis fișierul, dar conținutul nu arată ca un fișier Excel real (.xlsx sau .xls), deși extensia spune altceva. De obicei e un CSV redenumit, un fișier gol sau descărcat incomplet. Citește-l cu read_csv dacă e text sau salvează-l din nou ca Excel.

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

Ce înseamnă

read_excel nu se uită doar la extensie: citește primii octeți ai fișierului ca să afle formatul (un .xlsx real e o arhivă ZIP, un .xls vechi are altă semnătură). Dacă primii octeți nu se potrivesc cu niciun format Excel, pandas nu știe ce cititor (engine) să folosească și îți cere să-l alegi manual.

În practică, alegerea manuală a cititorului rareori ajută, pentru că fișierul chiar nu e Excel. Situațiile tipice: un export care e de fapt CSV sau HTML, salvat cu extensia .xlsx; un fișier gol (0 octeți) sau descărcat pe jumătate; fișierul temporar ~$raport.xlsx pe care Excel îl creează cât timp ai documentul deschis.

Deschide fișierul într-un editor de text: dacă vezi rânduri cu virgule, e un CSV.

De ce apare: cauzele frecvente

1Fișierul e un CSV cu extensia .xlsx

Greșit
PYTHON
df = pd.read_excel("export.xlsx")  # în interior: text cu virgule
Corect
PYTHON
df = pd.read_csv("export.xlsx")

Conținutul decide formatul, nu extensia. Un fișier text se citește cu read_csv, oricum s-ar numi.

2Fișierul temporar al lui Excel

Greșit
PYTHON
for f in glob.glob("date/*.xlsx"):
    pd.read_excel(f)  # include ~$vanzari.xlsx
Corect
PYTHON
for f in glob.glob("date/*.xlsx"):
    if not os.path.basename(f).startswith("~$"):
        pd.read_excel(f)

Fișierul ~$... e un fișier mic de blocare, nu un registru, și apare doar cât timp documentul e deschis în Excel.

3Fișier gol sau descărcat incomplet

Greșit
PYTHON
df = pd.read_excel("raport.xlsx")  # 0 octeți
Corect
PYTHON
import os
if os.path.getsize("raport.xlsx") > 0:
    df = pd.read_excel("raport.xlsx")

Un fișier gol nu are nicio semnătură de format. Descarcă-l din nou sau verifică dimensiunea înainte.

Repară tu

Repară eroarea, direct în pagină

Sistemul de vânzări a trimis un fișier vanzari.xlsx, dar pd.read_excel dă ValueError: Excel file format cannot be determined, you must specify an engine manually.. Fișierul e de fapt text cu valori separate prin virgulă. Repară citirea ca să afișeze totalul vânzărilor.

Codul care dă eroarea
PYTHON
import pandas as pd

with open("vanzari.xlsx", "w") as f:
    f.write("produs,valoare\nlaptop,3200\nmouse,85\nmonitor,950\n")

df = pd.read_excel("vanzari.xlsx")
print(df["valoare"].sum())
După reparație, programul afișează
4235
Indiciu

Conținutul e CSV, deci citește-l cu pd.read_csv, chiar dacă extensia e .xlsx.

Alte forme ale mesajului

  • zipfile.BadZipFile: File is not a zip file

Cum o eviți pe viitor

  • Când primești un „Excel” dintr-un export automat, deschide-l întâi într-un editor de text sau verifică primii octeți.
  • Dacă sistemul exportă de fapt CSV, citește-l cu read_csv și cere ca exportul să aibă extensia corectă.
  • Sari peste fișierele care încep cu ~$ când citești toate fișierele dintr-un folder.
  • Verifică dimensiunea fișierelor descărcate înainte de citire.

Întrebări frecvente

Ajută dacă pun engine="openpyxl"?

Doar dacă fișierul e chiar .xlsx. Pentru un CSV redenumit primești altă eroare, zipfile.BadZipFile: File is not a zip file, pentru că .xlsx e o arhivă ZIP, iar textul nu este.

Cum aflu rapid ce format are fișierul?

Citește primii octeți: open("f.xlsx", "rb").read(4). Un .xlsx real începe cu b'PK' (semnătura ZIP). Dacă vezi litere obișnuite, e un fișier text.

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.