윈도우즈에 Django 설치하기

이 문서에서는 Windows에 Python 3.14 및 Django를 설치하는 방법을 안내합니다. 또한 Python 프로젝트를 보다 쉽게 작업할 수 있도록 가상 환경 설정 방법도 설명합니다. 이 문서는 Django 프로젝트를 진행하는 사용자들을 위한 초보자 가이드이며, Django 자체의 변경 사항을 개발할 때 Django를 설치하는 방법을 설명하는 문서는 아닙니다.

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

파이썬 설치

Django는 Python 웹 프레임워크이므로 컴퓨터에 Python이 설치되어 있어야 합니다. 작성 시점 기준으로 Python 3.14가 최신 버전입니다.

컴퓨터에 Python을 설치하려면 https://www.python.org/downloads/로 이동합니다. 웹 사이트에서 최신 Python 버전에 대한 다운로드 버튼을 제공해야 합니다. 실행 가능한 설치 프로그램을 다운로드하고 실행합니다. “모든 사용자를 위한 런처 설치(권장)” 옆의 확인란을 선택한 다음 “지금 설치”를 클릭합니다.

설치 후 커맨드 프롬프트를 열고 다음 명령을 실행하여 Python 버전이 설치한 Python 버전과 일치하는지 확인하세요.

...\> py --version

py 명령을 인식할 수 없거나 찾을 수 없습니다

Python을 설치한 방식(예: Microsoft Store)에 따라 커맨드 프롬프트에서 py 명령을 사용하지 못할 수도 있습니다.

그럴 경우 명령을 입력할 때 py 대신 ``python``을 사용해야 합니다.

더 보기

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

pip에 대하여

:pypi:`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

이렇게 하면 ‘project-name’이라는 폴더가 없을 경우 해당 폴더가 새로 생성되고 가상 환경이 설정됩니다. 환경을 활성화하려면 다음을 실행하세요.

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

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

장고 설치

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

명령 프롬프트에서 가상 환경이 활성화된 상태로 다음 명령을 실행합니다.

...\> py -m pip install Django

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

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

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

컬러 터미널 출력

삶의 질 기능은 터미널에 (흑백이 아닌) 컬러 출력을 추가합니다. 최신 터미널에서는 CMD와 PowerShell 모두에서 작동합니다. 비활성화해야 하는 경우, 환경 변수 :envvar:`DJANGO_COLORS`를 ``nocolor``로 설정하십시오.

이전 버전의 Windows 또는 레거시 터미널에서 구문 색상 표시를 활성화하려면 colorama 0.4.6+를 설치해야 합니다.

...\> py -m pip install "colorama >= 0.4.6"

색상 설정에 대한 자세한 내용은 :ref:`syntax-coloring`을 참조하세요.

공통적인 함정

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

• 프록시를 통해 인터넷에 연결된 경우 ``py -m pip install Django``라는 명령을 실행할 때 문제가 발생할 수 있습니다. 명령 프롬프트에서 다음과 같이 프록시 설정 환경 변수를 지정하세요.

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

• 일반적으로, Django는 UTF-8 인코딩이 I/O에 사용된다고 가정합니다. 시스템이 다른 인코딩을 사용하도록 설정된 경우 이로 인해 문제가 발생할 수 있습니다. 최신 버전의 Python에서는 UTF-8 인코딩을 강제하기 위해 PYTHONUTF8 환경 변수를 설정할 수 있습니다. Windows 10은 또한 시스템 설정의 :menuselection:`언어 –> 관리 언어 설정 –> 시스템 로케일 변경`에서 ``세계 언어 지원에 유니코드 UTF-8 사용``을 선택하여 시스템 전체 설정을 제공합니다.