python · Python
A mensagem
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xff in position 0: invalid start byte
O que significa
Você leu um arquivo ou uma sequência de bytes como UTF-8 e encontrou um byte que o UTF-8 não permite; a mensagem indica a posição e o byte. Em geral o arquivo é cp1252 ou outra codificação antiga vinda do Windows, ou não é texto: uma imagem, um zip, ou dados gzip que você esqueceu de descomprimir. O certo é descobrir a codificação real e passá-la em encoding=; errors="replace" deixa a leitura terminar, mas troca esses bytes por interrogações, e o dado segue silenciosamente corrompido.
A correção
Não há um comando de uma linha. A explicação diz o que verificar.
- Impresso por
- python
- Python
- 18
Um traceback do Python divide a resposta em duas partes — a última linha diz o que deu errado e os quadros acima dizem onde — então ler só a última linha dá o nome e perde o lugar; e nos erros de valor ausente, como NoneType e KeyError, a causa quase sempre está num quadro acima daquele que quebrou.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “UnicodeDecodeError: 'utf-8' codec can't decode byte 0xff in position 0: invalid start byte”?
Você leu um arquivo ou uma sequência de bytes como UTF-8 e encontrou um byte que o UTF-8 não permite; a mensagem indica a posição e o byte. Em geral o arquivo é cp1252 ou outra codificação antiga vinda do Windows, ou não é texto: uma imagem, um zip, ou dados gzip que você esqueceu de descomprimir. O certo é descobrir a codificação real e passá-la em encoding=; errors="replace" deixa a leitura terminar, mas troca esses bytes por interrogações, e o dado segue silenciosamente corrompido.
Q. Como corrigir?
Não há comando de uma linha. A explicação acima diz o que verificar.
Q. Qual ferramenta imprime isso?
python. Fica em Python e a mensagem tem 13 palavras.