{"title":"Soluções de Problemas","version":"1.11","locale":"pt-br","docname":"faq/troubleshooting","url":"/pt-br/1.11/faq/troubleshooting/","canonical":"https://djangodocs.dev/pt-br/1.11/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>“comando não encontrado: django-admin”<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/1.11/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/1.11/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>If you’re using macOS, you may see the message “permission denied” when\nyou try to run <code class=\"docutils literal notranslate\">django-admin</code>. This is because, on Unix-based systems like\nmacOS, a file must be marked as “executable” before it can be run as a program.\nTo do this, open Terminal.app and navigate (using the <code class=\"docutils literal notranslate\">cd</code> command) to the\ndirectory where <a class=\"reference internal\" href=\"/pt-br/1.11/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> is installed, then\nrun the command <code class=\"docutils literal notranslate\">sudo chmod +x django-admin</code>.</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>\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<li><p>Você criou um raw bytestrings, o que é fácil de fazer em Python 2:</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>my_string <span class=\"o\">=</span> <span class=\"s1\">&#39;café&#39;</span>\n</code></pre></div>\n<p>Use o prefixo <code class=\"docutils literal notranslate\">u''</code> ou até melhor, adicione a linha <code class=\"docutils literal notranslate\">from __future__ import unicode_literals</code> no topo do arquivo para torná-lo compatível com Python 3.2, que não suporta o prefixo <code class=\"docutils literal notranslate\">u''</code>.</p>\n</li>\n</ul>\n<p>Recursos relacionados:</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/pt-br/1.11/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/1.11/faq/"}],"prev":{"docname":"faq/contributing","title":"FAQ: Contribuindo com o código","url":"/pt-br/1.11/faq/contributing/"},"next":{"docname":"ref/index","title":"Referência da API","url":"/pt-br/1.11/ref/"},"formats":{"html":"/pt-br/1.11/faq/troubleshooting/","markdown":"/pt-br/1.11/faq/troubleshooting.md","json":"/pt-br/1.11/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/pt-br/1.11/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","fr","ja","id","pt-br","ko","es","el","pl"]}