윈도우즈에 Django 설치하기

이 문서는 Windows에 Python 3.8 및 Django를 설치하는 과정을 안내합니다. 또한 Python 프로젝트에서 보다 쉽게 작업할 수 있도록 가상 환경 설정에 대한 지침을 제공합니다. 이것은 Django 프로젝트를 하는 사용자들을 위한 초보자 가이드로서 의미되며, Django 자체에 대한 패치를 개발할 때 Django가 어떻게 설치되어야 하는지 반영하지 않습니다.

이 가이드의 단계는 Windows 10에서 테스트되었습니다. 다른 버전에서는 단계가 비슷합니다. Windows(윈도우) 명령 프롬프트를 사용하는 방법을 숙지해야 합니다.

파이썬 설치

Django는 Python 웹 프레임워크이므로 Python을 컴퓨터에 설치해야 합니다. 현재 Python 3.8은 최신 버전입니다.

To install Python on your machine go to https://www.python.org/downloads/. The website should offer you a download button for the latest Python version. Download the executable installer and run it. Check the boxes next to “Install launcher for all users (recommended)” then click “Install Now”.

설치 후에는 커맨드 프롬프트를 열어서 설치된 파이썬 버전과 방금 설치한 파이썬 버전이 같은지 확인하세요.

...\> py --version

더 보기

자세한 내용은:doc:’python:using/window’ 설명서를 참조하십시오.

pip에 대하여

pip_은(는) Python용 패키지 관리자이며 기본적으로 Python 설치 관리자에 포함되어 있습니다. Python 패키지(예: Django!)를 설치하고 제거하는 데 도움이 됩니다. 나머지 설치 시에는 “pip”을 사용하여 명령줄에서 Python 패키지를 설치할 것입니다.

가상 환경을 설정합니다.

생성하는 각 Django 프로젝트에 전용 환경을 제공하는 것이 좋습니다. 파이썬 생태계 내 환경 및 패키지를 관리할 수 있는 여러 가지 옵션이 있으며 이 중 일부는 파이썬 설명서(https://packaging.python.org/guides/tool-recommendations/)에 나와 있습니다. Python 자체는 우리가 이 가이드에 사용할 환경을 관리하기 위한 :doc:’venv <python:tutorial/venv’와 함께 제공됩니다.

프로젝트의 가상 환경을 생성하려면 새 명령 프롬프트를 열고 프로젝트를 생성할 폴더로 이동한 다음 다음을 입력합니다.

...\> py -m venv project-name

This will create a folder called ‘project-name’ if it does not already exist and set up the virtual environment. To activate the environment, run:

...\> project-name\Scripts\activate.bat

가상 환경이 활성화되고 명령 프롬프트 옆에 “(프로젝트 이름)”이 표시되어 가상 환경을 지정합니다. 새 명령 프롬프트를 시작할 때마다 환경을 다시 활성화해야 합니다.

장고 설치

Django는 가상 환경 내에서 “pip”을 사용하여 쉽게 설치할 수 있습니다.

명령 프롬프트에서 가상 환경이 활성 상태인지 확인하고 다음 명령을 실행합니다.

...\> py -m pip install Django

그러면 최신 Django 릴리스가 다운로드되고 설치됩니다.

설치가 완료되면 명령 프롬프트에서 “django-admin –version”을 실행하여 Django 설치를 확인할 수 있습니다.

Django와의 데이터베이스 설치에 대한 자세한 내용은:ref:’데이터베이스 설치’를 참조하십시오.

Colored terminal output

New in Django 3.2.

A quality-of-life feature adds colored (rather than monochrome) output to the terminal. In modern terminals this should work for both CMD and PowerShell. If for some reason this needs to be disabled, set the environmental variable DJANGO_COLORS to nocolor.

On older Windows versions, or legacy terminals, colorama must be installed to enable syntax coloring:

...\> py -m pip install colorama

See Syntax coloring for more information on color settings.

공통적인 함정

• 만약 “django-admin”이 어떤 주장이 주어지더라도 도움말 텍스트만 표시한다면, 윈도우의 파일 연결에 문제가 있을 것입니다. “PATH”에서 Python 스크립트를 실행하기 위해 둘 이상의 환경 변수가 설정되어 있는지 확인합니다. 일반적으로 Python 버전이 두 개 이상 설치된 경우 이러한 문제가 발생합니다.

• 만일 당신이 대리인을 통해 인터넷에 접속한다면 ``py-mp install Django”라는 명령어를 실행하는 데 문제가 있을 수 있습니다. 명령 프롬프트에서 다음과 같이 프록시 구성에 대한 환경 변수를 설정합니다.

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  

• In general, Django assumes that UTF-8 encoding is used for I/O. This may cause problems if your system is set to use a different encoding. Recent versions of Python allow setting the PYTHONUTF8 environment variable in order to force a UTF-8 encoding. Windows 10 also provides a system-wide setting by checking Use Unicode UTF-8 for worldwide language support in Language ‣ Administrative Language Settings ‣ Change system locale in system settings.