{"title":"错误调试","version":"2.2","locale":"zh-hans","docname":"faq/troubleshooting","url":"/zh-hans/2.2/faq/troubleshooting/","canonical":"https://djangodocs.dev/zh-hans/2.2/faq/troubleshooting/","summary":"本页包含了开发Django应用过程中一些常见错误和问题的处理建议。 运行 django-admin 时遇到的问题 Link to this heading # “未找到 django-admin 命令” Link to this heading # django-admin should be on your system…","html":"<h1>错误调试<a class=\"heading-anchor\" href=\"#troubleshooting\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>本页包含了开发Django应用过程中一些常见错误和问题的处理建议。</p>\n<section id=\"problems-running-django-admin\">\n<span id=\"troubleshooting-django-admin\"></span><h2>运行 <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 to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"command-not-found-django-admin\">\n<h3>“未找到 django-admin 命令”<a class=\"heading-anchor\" href=\"#command-not-found-django-admin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p><a class=\"reference internal\" href=\"/zh-hans/2.2/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> should be on your system path if you\ninstalled Django via <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code>. If it's not on your path, you can find it in\n<code class=\"docutils literal notranslate\"><span class=\"pre\">site-packages/django/bin</span></code>, where <code class=\"docutils literal notranslate\"><span class=\"pre\">site-packages</span></code> is a directory within\nyour Python installation. Consider symlinking to <a class=\"reference internal\" href=\"/zh-hans/2.2/ref/django-admin/\"><span class=\"doc\">django-admin</span></a> from some place on your path, such as\n<code class=\"file docutils literal notranslate\"><span class=\"pre\">/usr/local/bin</span></code>.</p>\n<p>如果 <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> 报错但是``django-admin.py``却可以，那说明可能你使用的Django版本和本文档的版本不一致。<a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>django-admin``是 Django 1.7中的新命令。</p>\n</section>\n<section id=\"macos-permissions\">\n<h3>macOS 的权限问题<a class=\"heading-anchor\" href=\"#macos-permissions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>如果你正在使用 macOS，你可能看到“permission denied”提示，当你尝试运行``django-admin``的时候。这是因为在像 macOS 这种类Unix系统中，一个文件在它被当作程序执行之前必须被标记为“可执行”。为了解决这个问题，打开终端并且进入 <span class=\"xref std std-doc\">django-admin `的安装目录（使用``cd``命令），然后执行命令``sudo chmod +x django-admin`</span>.</p>\n</section>\n</section>\n<section id=\"miscellaneous\">\n<h2>杂项<a class=\"heading-anchor\" href=\"#miscellaneous\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong\">\n<h3>我遇到了错误信息 <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeDecodeError</span></code>。 我哪里做错了？<a class=\"heading-anchor\" href=\"#i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>当包含非ASCII序列的字符串被转换为Unicode字符串，并且指定的编码不正确时，会发生此类错误。 输出一般看起来像这样:</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> <span class=\"n\">codec</span> <span class=\"n\">can</span><span class=\"s1\">&#39;t decode byte 0x?? in position ?:</span>\n<span class=\"n\">ordinal</span> <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>解决方案主要取决于上下文，但是这里有两个常见的陷阱产生这个错误：</p>\n<ul class=\"simple\">\n<li><p>您的系统语言环境可能是默认的ASCII，比如类UNIX系统上的 “C” （可通过命令 <code class=\"docutils literal notranslate\"><span class=\"pre\">locale</span></code> 进行检查）。如果是这种情况，请参考您的系统文档以了解如何将其更改为UTF-8语言环境。</p></li>\n</ul>\n<p>关联资源：</p>\n<ul class=\"simple\">\n<li><p>：文档：Django 中的 Unicode&lt;/ref/unicode&gt;</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":"运行 django-admin 时遇到的问题","anchor":"problems-running-django-admin","children":[{"title":"“未找到 django-admin 命令”","anchor":"command-not-found-django-admin","children":[]},{"title":"macOS 的权限问题","anchor":"macos-permissions","children":[]}]},{"title":"杂项","anchor":"miscellaneous","children":[{"title":"我遇到了错误信息 UnicodeDecodeError。 我哪里做错了？","anchor":"i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong","children":[]}]}],"breadcrumbs":[{"docname":"faq/index","title":"Django FAQ","url":"/zh-hans/2.2/faq/"}],"prev":{"docname":"faq/contributing","title":"FAQ：贡献代码","url":"/zh-hans/2.2/faq/contributing/"},"next":{"docname":"ref/index","title":"API参考","url":"/zh-hans/2.2/ref/"},"formats":{"html":"/zh-hans/2.2/faq/troubleshooting/","markdown":"/zh-hans/2.2/faq/troubleshooting.md","json":"/zh-hans/2.2/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/zh-hans/2.2/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"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}