--- title: "Soluções de Problemas" version: 5.1 locale: pt-br source: https://docs.djangoproject.com/pt-br/5.1/faq/troubleshooting/ canonical: https://djangodocs.dev/pt-br/5.1/faq/troubleshooting/ --- # Soluções de Problemas Essa página contém alguns conselhos sobre erros e problemas comumente encontrados durante o desenvolvimento de aplicações em Django. ## Problemas ao rodar o `django-admin` ### `comando não encontrado: django-admin` O [django-admin](/pt-br/5.1/ref/django-admin/) deve estar no caminho do seu sistema se você instalou o Django via `pip`. Se não estiver em seu caminho, certifique-se de ter seu ambiente virtual ativado e você pode tentar executar o comando equivalente `python -m django`. ### permissões do macOS Se você está usando macOS, você pode ver a mensagem “permissão negada” quando tentar rodar o “django-admin”. Isso acontece porque, sistemas baseados em Unix como o macOS, um arquivo precisa ser marcado como “executável” antes de poder ser executado como um programa. Para fazer isso, abra o terminal e navegue (usando o comando “cd”) até o diretório onde django-admin 1 está instalado, então rode o comando “sudo chmod +x django-admin”. ## Variados ### Estou recebendo um `UnicodeDecodeError`. O que estou fazendo de errado? Esta classe de erros acontece quando uma bytestring contendo sequências não ASCII é transformado em uma sequência de caracteres Unicode e a codificação especificada está incorreta. A saída geralmente se parece com isso: ```pytb UnicodeDecodeError: 'ascii' codec can't decode byte 0x?? in position ?: ordinal not in range(128) ``` A resolução depende principalmente do contexto, entretanto aqui estão as duas armadilhas comuns que produzem este erro: - O locale padrão do sistema pode estar definido como ASCII, como o locale “C” nos sistemas baseados em UNIX (você pode checar com o comando `locale`). Se este é o caso, por favor, consulte a documentação do sistema para aprender como mudar para o locale: UTF-8. Recursos relacionados: - [Unicode em Django](/pt-br/5.1/ref/unicode/) -