{"title":"윈도우즈에 Django 설치하기","version":"2.2","locale":"ko","docname":"howto/windows","url":"/ko/2.2/howto/windows/","canonical":"https://djangodocs.dev/ko/2.2/howto/windows/","summary":"이 문서에서는 윈도우즈에 파이썬 3.5와 Django를 설치하는 법을 안내할 것입니다. 파이썬 프로젝트를 좀 더 쉽게 작업하게 해주는 virtualenv 와 virtualenvwrapper 설치에 대한 안내도 제공합니다. Django를 사용하는 초보자들을 위한 가이드이며 Django가 어떻게…","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>이 문서에서는 윈도우즈에 파이썬 3.5와 Django를 설치하는 법을 안내할 것입니다. 파이썬 프로젝트를 좀 더 쉽게 작업하게 해주는 <a class=\"reference external\" href=\"https://pypi.org/project/virtualenv/\">virtualenv</a>와 <a class=\"reference external\" href=\"https://pypi.org/project/virtualenvwrapper-win/\">virtualenvwrapper</a> 설치에 대한 안내도 제공합니다. Django를 사용하는 초보자들을 위한 가이드이며 Django가 어떻게 설치되어야 하는지에 대한 내용은 아닙니다.</p>\n<p>이 가이드 내용은 윈도우즈 7, 8, 10에서 테스트했습니다. 다른 버전에서도 각 단계는 유사할 것입니다. 가이드를 따라오기 위해서 윈도우즈 커맨드 프롬프트에 친숙해질 필요가 있습니다.</p>\n<section id=\"install-python\">\n<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는 파이썬 웹 프레임워크이므로 설치를 위해서는 파이썬이 필요합니다. 이 글을 쓰는 시점을 기준으로 파이썬 최신판은 3.5입니다.</p>\n<p>컴퓨터에 파이썬을 설치하기 위해 <a class=\"reference external\" href=\"https://python.org/downloads\">https://python.org/downloads</a>/에 가시기 바랍니다. 이 사이트에서 다운로드 버튼을 이용해서 최신판 파이썬을 받을 수 있습니다. 실행가능한 설치 파일을 받아서 실행하세요. <code class=\"docutils literal notranslate\"><span class=\"pre\">Add</span> <span class=\"pre\">Python</span> <span class=\"pre\">3.5</span> <span class=\"pre\">to</span> <span class=\"pre\">PATH</span></code> 옆의 체크 박스를 클릭하고 설치를 시작하세요.</p>\n<p>설치 후에는 커맨드 프롬프트를 열어서 설치된 파이썬 버전과 방금 설치한 파이썬 버전이 같은지 확인하세요.</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=\"n\">python</span> <span class=\"o\">--</span><span class=\"n\">version</span>\n</code></pre></div>\n</section>\n<section id=\"about-pip\">\n<h2><code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></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><a class=\"reference external\" href=\"https://pypi.org/project/pip/\">pip</a> is a package manage for Python. It makes installing and uninstalling\nPython packages (such as Django!) very easy. For the rest of the installation,\nwe’ll use <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> to install Python packages from the command line.</p>\n<p>To install pip on your machine, go to\n<a class=\"reference external\" href=\"https://pip.pypa.io/en/latest/installing/\">https://pip.pypa.io/en/latest/installing/</a>, and follow the <code class=\"docutils literal notranslate\"><span class=\"pre\">Installing</span> <span class=\"pre\">with</span>\n<span class=\"pre\">get-pip.py</span></code> instructions.</p>\n</section>\n<section id=\"install-virtualenv-and-virtualenvwrapper\">\n<h2>Install <code class=\"docutils literal notranslate\"><span class=\"pre\">virtualenv</span></code> and <code class=\"docutils literal notranslate\"><span class=\"pre\">virtualenvwrapper</span></code><a class=\"heading-anchor\" href=\"#install-virtualenv-and-virtualenvwrapper\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference external\" href=\"https://pypi.org/project/virtualenv/\">virtualenv</a> and <a class=\"reference external\" href=\"https://pypi.org/project/virtualenvwrapper-win/\">virtualenvwrapper</a> provide a dedicated environment for\neach Django project you create. While not mandatory, this is considered a best\npractice and will save you time in the future when you’re ready to deploy your\nproject. Simply type:</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=\"n\">pip</span> <span class=\"n\">install</span> <span class=\"n\">virtualenvwrapper</span><span class=\"o\">-</span><span class=\"n\">win</span>\n</code></pre></div>\n<p>Then create a virtual environment for your project:</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=\"n\">mkvirtualenv</span> <span class=\"n\">myproject</span>\n</code></pre></div>\n<p>The virtual environment will be activated automatically and you’ll see\n“(myproject)” next to the command prompt to designate that. If you start a new\ncommand prompt, you’ll need to activate the environment again using:</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=\"n\">workon</span> <span class=\"n\">myproject</span>\n</code></pre></div>\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 can be installed easily using <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> within your virtual environment.</p>\n<p>In the command prompt, ensure your virtual environment is active, and execute\nthe following command:</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=\"n\">pip</span> <span class=\"n\">install</span> <span class=\"n\">django</span>\n</code></pre></div>\n<p>This will download and install the latest Django release.</p>\n<p>After the installation has completed, you can verify your Django installation\nby executing <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">--version</span></code> in the command prompt.</p>\n<p>See <a class=\"reference internal\" href=\"/ko/2.2/topics/install/#database-installation\"><span class=\"std std-ref\">데이터베이스 구동</span></a> for information on database installation\nwith Django.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Common pitfalls<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>If <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> only displays the help text no matter what arguments\nit is given, there is probably a problem with the file association in\nWindows. Check if there is more than one environment variable set for\nrunning Python scripts in <code class=\"docutils literal notranslate\"><span class=\"pre\">PATH</span></code>. This usually occurs when there is more\nthan one Python version installed.</p></li>\n<li><p>If you are connecting to the internet behind a proxy, there might be problem\nin running the command <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span> <span class=\"pre\">install</span> <span class=\"pre\">django</span></code>. Set the environment variables\nfor proxy configuration in the command prompt as follows:</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=\"nb\">set</span> <span class=\"n\">http_proxy</span><span class=\"o\">=</span><span class=\"n\">http</span><span class=\"p\">:</span><span class=\"o\">//</span><span class=\"n\">username</span><span class=\"p\">:</span><span class=\"n\">password</span><span class=\"nd\">@proxyserver</span><span class=\"p\">:</span><span class=\"n\">proxyport</span>\n<span class=\"nb\">set</span> <span class=\"n\">https_proxy</span><span class=\"o\">=</span><span class=\"n\">https</span><span class=\"p\">:</span><span class=\"o\">//</span><span class=\"n\">username</span><span class=\"p\">:</span><span class=\"n\">password</span><span class=\"nd\">@proxyserver</span><span class=\"p\">:</span><span class=\"n\">proxyport</span>\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":"Install virtualenv and virtualenvwrapper","anchor":"install-virtualenv-and-virtualenvwrapper","children":[]},{"title":"장고 설치","anchor":"install-django","children":[]},{"title":"Common pitfalls","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"“How-to” 가이드","url":"/ko/2.2/howto/"}],"prev":{"docname":"howto/static-files/index","title":"정적 파일 관리하기(e.g. 이미지, 자바스크립트, CSS)","url":"/ko/2.2/howto/static-files/"},"next":{"docname":"howto/writing-migrations","title":"Writing database migrations","url":"/ko/2.2/howto/writing-migrations/"},"formats":{"html":"/ko/2.2/howto/windows/","markdown":"/ko/2.2/howto/windows.md","json":"/ko/2.2/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/ko/2.2/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"]}