{"title":"Soluções de Problemas","version":"3.0","locale":"pt-br","docname":"faq/troubleshooting","url":"/pt-br/3.0/faq/troubleshooting/","canonical":"https://djangodocs.dev/pt-br/3.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.","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\">django-admin</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\">command not found: django-admin</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/3.0/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> deve estar no caminho do seu sistema caso tenha instalado o Django via: <code class=\"docutils literal notranslate\">python setup.py</code>. Caso ele não esteja no seu caminho você pode encontrá-lo em <code class=\"docutils literal notranslate\">site-packages/django/bin</code>, onde <code class=\"docutils literal notranslate\">site-packages</code> é um diretório dentro do seu projeto em Python. Considere criar um link simbólico <a class=\"reference internal\" href=\"/pt-br/3.0/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> a partir de algum lugar em seu caminho, tal como <code class=\"file docutils literal notranslate\">/usr/local/bin</code>.</p>\n<p>Se o <code class=\"docutils literal notranslate\">django-admin</code> não funciona mas, <code class=\"docutils literal notranslate\">django-admin.py</code> sim, você provavelmente está usando uma versão antiga do Django que não coincide com a versão desta documentação.  <code class=\"docutils literal notranslate\">django-admin</code> é novo no Django 1.7.</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\">UnicodeDecodeError</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>Estas classes de erros acontecem quando um 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=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"ne\">UnicodeDecodeError</span><span class=\"p\">:</span> <span class=\"s1\">&#39;ascii&#39;</span> codec can<span class=\"s1\">&#39;t decode byte 0x?? in position ?:</span>\nordinal <span class=\"ow\">not</span> <span class=\"ow\">in</span> <span class=\"nb\">range</span><span class=\"p\">(</span><span class=\"mi\">128</span><span class=\"p\">)</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\">locale</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/3.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":"command not found: 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/3.0/faq/"}],"prev":{"docname":"faq/contributing","title":"FAQ: Contribuindo com o código","url":"/pt-br/3.0/faq/contributing/"},"next":{"docname":"ref/index","title":"Referência da API","url":"/pt-br/3.0/ref/"},"formats":{"html":"/pt-br/3.0/faq/troubleshooting/","markdown":"/pt-br/3.0/faq/troubleshooting.md","json":"/pt-br/3.0/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/3.0.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/pt-br/3.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","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}