Início·Mensagens de erro

python 3.11+ · Python

A mensagem

UnboundLocalError: cannot access local variable 'count' where it is not associated with a value

O que significa

Se uma função atribui a um nome em qualquer ponto do seu corpo, o Python trata esse nome como local à função — e você o leu antes de a atribuição rodar. Aparece quando você esperava ver o valor de fora com o mesmo nome, ou na primeira vez que escreve uma operação de leitura e escrita como count += 1. Inicializar dentro da função com count = 0 é a resposta comum; se precisar mesmo alterar o valor de módulo, global count faz isso, ao custo de um valor cujos escritores ficam difíceis de rastrear. Até a 3.10 o mesmo erro dizia 'local variable referenced before assignment'.

A correção

Não há um comando de uma linha. A explicação diz o que verificar.

Impresso por
python 3.11+
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 “UnboundLocalError: cannot access local variable 'count' where it is not associated with a value”?

Se uma função atribui a um nome em qualquer ponto do seu corpo, o Python trata esse nome como local à função — e você o leu antes de a atribuição rodar. Aparece quando você esperava ver o valor de fora com o mesmo nome, ou na primeira vez que escreve uma operação de leitura e escrita como count += 1. Inicializar dentro da função com count = 0 é a resposta comum; se precisar mesmo alterar o valor de módulo, global count faz isso, ao custo de um valor cujos escritores ficam difíceis de rastrear. Até a 3.10 o mesmo erro dizia 'local variable referenced before assignment'.

Q. Como corrigir?

Não há comando de uma linha. A explicação acima diz o que verificar.

Q. Qual ferramenta imprime isso?

python 3.11+. Fica em Python e a mensagem tem 14 palavras.

Erros próximos