{"title":"윈도우즈에 Django 설치하기","version":"3.1","locale":"ko","docname":"howto/windows","url":"/ko/3.1/howto/windows/","canonical":"https://djangodocs.dev/ko/3.1/howto/windows/","summary":"이 문서는 Windows에 Python 3.8 및 Django를 설치하는 과정을 안내합니다. 또한 Python 프로젝트에서 보다 쉽게 작업할 수 있도록 가상 환경 설정에 대한 지침을…","html":"<h1>윈도우즈에 Django 설치하기<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>이 문서는 Windows에 Python 3.8 및 Django를 설치하는 과정을 안내합니다. 또한 Python 프로젝트에서 보다 쉽게 작업할 수 있도록 가상 환경 설정에 대한 지침을 제공합니다. 이것은 Django 프로젝트를 하는 사용자들을 위한 초보자 가이드로서 의미되며, Django 자체에 대한 패치를 개발할 때 Django가 어떻게 설치되어야 하는지 반영하지 않습니다.</p>\n<p>이 가이드의 단계는 Windows 10에서 테스트되었습니다. 다른 버전에서는 단계가 비슷합니다. Windows(윈도우) 명령 프롬프트를 사용하는 방법을 숙지해야 합니다.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><h2>파이썬 설치<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django는 Python 웹 프레임워크이므로 Python을 컴퓨터에 설치해야 합니다. 현재 Python 3.8은 최신 버전입니다.</p>\n<p>컴퓨터에 Python을 설치하려면 <a class=\"reference external\" href=\"https://python.org/downloads\">https://python.org/downloads</a>/으로 이동하십시오. 웹 사이트에서 최신 Python 버전에 대한 다운로드 버튼을 제공합니다. 실행 파일 설치 프로그램을 다운로드하여 실행합니다. 모든 사용자를 위한 시작 프로그램 설치(권장) 옆에 있는 상자를 선택한 후 “지금 설치”를 누릅니다.</p>\n<p>설치 후에는 커맨드 프롬프트를 열어서 설치된 파이썬 버전과 방금 설치한 파이썬 버전이 같은지 확인하세요.</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition admonition-seealso\" role=\"note\">\n<p class=\"admonition-title\">더 보기</p>\n<p>자세한 내용은:doc:’python:using/window’ 설명서를 참조하십시오.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2><code class=\"docutils literal notranslate\">pip</code>에 대하여<a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>pip_은(는) Python용 패키지 관리자이며 기본적으로 Python 설치 관리자에 포함되어 있습니다. Python 패키지(예: Django!)를 설치하고 제거하는 데 도움이 됩니다. 나머지 설치 시에는 “pip”을 사용하여 명령줄에서 Python 패키지를 설치할 것입니다.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>가상 환경을 설정합니다.<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>생성하는 각 Django 프로젝트에 전용 환경을 제공하는 것이 좋습니다. 파이썬 생태계 내 환경 및 패키지를 관리할 수 있는 여러 가지 옵션이 있으며 이 중 일부는 파이썬 설명서(<a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">https://packaging.python.org/guides/tool-recommendations/</a>)에 나와 있습니다. Python 자체는 우리가 이 가이드에 사용할 환경을 관리하기 위한 :doc:’venv &lt;python:tutorial/venv’와 함께 제공됩니다.</p>\n<p>프로젝트의 가상 환경을 생성하려면 새 명령 프롬프트를 열고 프로젝트를 생성할 폴더로 이동한 다음 다음을 입력합니다.</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>이렇게 하면 ‘프로젝트 이름’ 폴더가 아직 없는 경우 해당 폴더가 생성되고 가상 환경이 설정됩니다. 환경을 활성화하려면 다음을 실행하십시오.</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>가상 환경이 활성화되고 명령 프롬프트 옆에 “(프로젝트 이름)”이 표시되어 가상 환경을 지정합니다. 새 명령 프롬프트를 시작할 때마다 환경을 다시 활성화해야 합니다.</p>\n</section>\n<section id=\"install-django\">\n<h2>장고 설치<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django는 가상 환경 내에서 “pip”을 사용하여 쉽게 설치할 수 있습니다.</p>\n<p>명령 프롬프트에서 가상 환경이 활성 상태인지 확인하고 다음 명령을 실행합니다.</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>그러면 최신 Django 릴리스가 다운로드되고 설치됩니다.</p>\n<p>설치가 완료되면 명령 프롬프트에서 “django-admin –version”을 실행하여 Django 설치를 확인할 수 있습니다.</p>\n<p>Django와의 데이터베이스 설치에 대한 자세한 내용은:ref:’데이터베이스 설치’를 참조하십시오.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>공통적인 함정<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>만약 “django-admin”이 어떤 주장이 주어지더라도 도움말 텍스트만 표시한다면, 윈도우의 파일 연결에 문제가 있을 것입니다. “PATH”에서 Python 스크립트를 실행하기 위해 둘 이상의 환경 변수가 설정되어 있는지 확인합니다. 일반적으로 Python 버전이 두 개 이상 설치된 경우 이러한 문제가 발생합니다.</p></li>\n<li><p>만일 당신이 대리인을 통해 인터넷에 접속한다면 <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>py-mp install Django”라는 명령어를 실행하는 데 문제가 있을 수 있습니다. 명령 프롬프트에서 다음과 같이 프록시 구성에 대한 환경 변수를 설정합니다.</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"파이썬 설치","anchor":"install-python","children":[]},{"title":"pip에 대하여","anchor":"about-pip","children":[]},{"title":"가상 환경을 설정합니다.","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"장고 설치","anchor":"install-django","children":[]},{"title":"공통적인 함정","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"“How-to” 가이드","url":"/ko/3.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"정적 파일 배포하기","url":"/ko/3.1/howto/static-files/deployment/"},"next":{"docname":"howto/writing-migrations","title":"데이터베이스 마이그레이션을 쓰는 중입니다.","url":"/ko/3.1/howto/writing-migrations/"},"formats":{"html":"/ko/3.1/howto/windows/","markdown":"/ko/3.1/howto/windows.md","json":"/ko/3.1/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/ko/3.1/howto/windows/","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"]}