{"title":"Soluções de Problemas","version":"6.0","locale":"pt-br","docname":"faq/troubleshooting","url":"/pt-br/6.0/faq/troubleshooting/","canonical":"https://djangodocs.dev/pt-br/6.0/faq/troubleshooting/","summary":"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…","html":"<h1>Soluções de Problemas<a class=\"heading-anchor\" href=\"#troubleshooting\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Essa página contém alguns conselhos sobre erros e problemas comumente encontrados durante o desenvolvimento de aplicações em Django.</p>\n<section id=\"problems-running-django-admin\">\n<span id=\"troubleshooting-django-admin\"></span><h2>Problemas ao rodar o <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code><a class=\"heading-anchor\" href=\"#problems-running-django-admin\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"command-not-found-django-admin\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">comando</span> <span class=\"pre\">não</span> <span class=\"pre\">encontrado:</span> <span class=\"pre\">django-admin</span></code><a class=\"heading-anchor\" href=\"#command-not-found-django-admin\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>O <a class=\"reference internal\" href=\"/pt-br/6.0/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> deve estar no caminho do seu sistema se você instalou o Django via <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code>. Se não estiver em seu caminho, certifique-se de ter seu ambiente virtual ativado e você pode tentar executar o comando equivalente <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span> <span class=\"pre\">-m</span> <span class=\"pre\">django</span></code>.</p>\n</section>\n<section id=\"macos-permissions\">\n<h3>permissões do macOS<a class=\"heading-anchor\" href=\"#macos-permissions\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>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 <span class=\"xref std std-doc\">django-admin 1</span> está instalado, então rode o comando “sudo chmod +x django-admin”.</p>\n</section>\n</section>\n<section id=\"miscellaneous\">\n<h2>Variados<a class=\"heading-anchor\" href=\"#miscellaneous\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong\">\n<h3>Estou recebendo um <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeDecodeError</span></code>. O que estou fazendo de errado?<a class=\"heading-anchor\" href=\"#i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>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:</p>\n<div class=\"code-block\" data-language=\"pytb\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Pytb</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Pytb code\"><code><span class=\"x\">UnicodeDecodeError: &#39;ascii&#39; codec can&#39;t decode byte 0x?? in position ?:</span>\n<span class=\"x\">ordinal not in range(128)</span>\n</code></pre></div>\n<p>A resolução depende principalmente do contexto, entretanto aqui estão as duas armadilhas comuns que produzem este erro:</p>\n<ul class=\"simple\">\n<li><p>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 <code class=\"docutils literal notranslate\"><span class=\"pre\">locale</span></code>). Se este é o caso, por favor, consulte a documentação do sistema para aprender como mudar para o locale: UTF-8.</p></li>\n</ul>\n<p>Recursos relacionados:</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/pt-br/6.0/ref/unicode/\"><span class=\"doc\">Unicode em Django</span></a></p></li>\n<li><p><a class=\"reference external\" href=\"https://wiki.python.org/moin/UnicodeDecodeError\">https://wiki.python.org/moin/UnicodeDecodeError</a></p></li>\n</ul>\n</section>\n</section>","rootId":"troubleshooting","toc":[{"title":"Problemas ao rodar o django-admin","anchor":"problems-running-django-admin","children":[{"title":"comando não encontrado: django-admin","anchor":"command-not-found-django-admin","children":[]},{"title":"permissões do macOS","anchor":"macos-permissions","children":[]}]},{"title":"Variados","anchor":"miscellaneous","children":[{"title":"Estou recebendo um UnicodeDecodeError. O que estou fazendo de errado?","anchor":"i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong","children":[]}]}],"breadcrumbs":[{"docname":"faq/index","title":"Django - Perguntas e dúvidas frequentes.","url":"/pt-br/6.0/faq/"}],"prev":{"docname":"faq/contributing","title":"FAQ: Contribuindo com o código","url":"/pt-br/6.0/faq/contributing/"},"next":{"docname":"ref/index","title":"Referência da API","url":"/pt-br/6.0/ref/"},"formats":{"html":"/pt-br/6.0/faq/troubleshooting/","markdown":"/pt-br/6.0/faq/troubleshooting.md","json":"/pt-br/6.0/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/pt-br/6.0/faq/troubleshooting/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}