{"title":"문제해결","version":"3.1","locale":"ko","docname":"faq/troubleshooting","url":"/ko/3.1/faq/troubleshooting/","canonical":"https://djangodocs.dev/ko/3.1/faq/troubleshooting/","summary":"이 페이지는 장고 애플리케이션을 개발하는 과정에 흔히 발생하는 에러와 문제들에 대한 조언들을 담고 있습니다.","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>이 페이지는 장고 애플리케이션을 개발하는 과정에 흔히 발생하는 에러와 문제들에 대한 조언들을 담고 있습니다.</p>\n<section id=\"problems-running-django-admin\">\n<span id=\"troubleshooting-django-admin\"></span><h2><code class=\"docutils literal notranslate\">django-admin</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><code class=\"docutils literal notranslate\">명령어를 찾을 수 없습니다: django-admin</code><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=\"/ko/3.1/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\">pip</code>. If it’s not in your path, ensure you have your\nvirtual environment activated and you can try running the equivalent command\n<code class=\"docutils literal notranslate\">python -m django</code>.</p>\n</section>\n<section id=\"macos-permissions\">\n<h3>맥OS 권한들<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를 사용하고 있다면 <code class=\"docutils literal notranslate\">django-admin``명령어를 사용하려 할 때, &quot;permission denied&quot;라는 메시지를 볼 수 있습니다. 이것은 macOS가 유닉스 기반의 시스템이라서 프로그램이 실행되기 전에 ``실행가능``으로 표시되어야 하기 떄문입니다. 이것을 해결하기 위해서는 터미널 앱을 열고 ``django-admin &lt;/ref/django-admin&gt;`이 설치된 곳으로 가서, ``sudo chmod +x django-admin</code> 명령어를 실행하세요.</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><a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>UnicodeDecodeError``가 발생합니다 무엇이 문제인가요?<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>이런 종류의 에러들은 non-ASCII 문자열을 포함하고 있는 바이트스트링이 유니코드로 변화하고 인코딩이 올바르지 않았을때 발생합니다. 결과물은 다음과 같이 보입니다.</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>상황에 따라 해법은 다릅니다. 하지만 여기 보통 에러를 발생시키는 두 가지 상황이 있습니다.</p>\n<ul class=\"simple\">\n<li><p>당신의 시스템 지역이 ASCII 기본 지역입니다. 유닉스 같은 시스템의 “C”로케일 같이 말이죠 ( <code class=\"docutils literal notranslate\">locale</code> 명령어로 확인할 수 있습니다.) 만약 이 경우라면, 시스템 문서를 참조하여 이것을 UTF-8로 바꾸는 방법을 연구해보세요.</p></li>\n</ul>\n<p>관련된 자원들:</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/ko/3.1/ref/unicode/\"><span class=\"doc\">장고의 유니코드</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":"django-admin을 실행하는 데 문제가 있습니다.","anchor":"problems-running-django-admin","children":[{"title":"명령어를 찾을 수 없습니다: django-admin","anchor":"command-not-found-django-admin","children":[]},{"title":"맥OS 권한들","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":"장고 자주묻는 질문","url":"/ko/3.1/faq/"}],"prev":{"docname":"faq/contributing","title":"자주 묻는 질문 : 코드에 기여하기","url":"/ko/3.1/faq/contributing/"},"next":{"docname":"ref/index","title":"API Reference","url":"/ko/3.1/ref/"},"formats":{"html":"/ko/3.1/faq/troubleshooting/","markdown":"/ko/3.1/faq/troubleshooting.md","json":"/ko/3.1/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/ko/3.1/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"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}