{"title":"문제해결","version":"5.1","locale":"ko","docname":"faq/troubleshooting","url":"/ko/5.1/faq/troubleshooting/","canonical":"https://djangodocs.dev/ko/5.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>:doc:<a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>django-admin &lt;/ref/django-admin&gt;`은 <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>pip``를 통해 장고를 설치한 경우 시스템 경로에 있어야 합니다. 만약 경로에 없으면 가상 환경이 활성화되어 있는지 확인하고, 명령 <a href=\"#id5\"><span class=\"problematic\" id=\"id6\">``</span></a>python -m django``를 실행해 확인할 수 있습니다.</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>This class of errors happen when a bytestring containing non-ASCII sequences is\ntransformed into a Unicode string and the specified encoding is incorrect. The\noutput generally looks like this:</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>상황에 따라 해법은 다릅니다. 하지만 여기 보통 에러를 발생시키는 두 가지 상황이 있습니다.</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/5.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/5.1/faq/"}],"prev":{"docname":"faq/contributing","title":"자주 묻는 질문 : 코드에 기여하기","url":"/ko/5.1/faq/contributing/"},"next":{"docname":"ref/index","title":"API 레퍼런스","url":"/ko/5.1/ref/"},"formats":{"html":"/ko/5.1/faq/troubleshooting/","markdown":"/ko/5.1/faq/troubleshooting.md","json":"/ko/5.1/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/ko/5.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","it","pt-br","ko","es","el","pl"]}