# Documentação Django 5.2.8

# 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 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:

    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

- https://wiki.python.org/moin/UnicodeDecodeError