Django 설치 및 프로젝트 생성
Django 프로젝트를 시작하려면 가상환경 생성, Django 설치, 프로젝트 생성 순서로 진행합니다.
1. 프로젝트 폴더 생성 및 가상환경 설정
Django를 시작하기 전 '가상환경'이라는 특별한 작업공간을 만들 것입니다. 가상환경을 사용하면 프로젝트마다 독립된 개발 환경을 만들 수 있습니다. 또한 프로젝트 간 충돌을 방지하고, 필요한 패키지만 설치하여 시스템을 깔끔하게 유지할 수 있습니다. 가상환경을 사용하면 프로젝트를 다른 환경으로 쉽게 이동할 수 있습니다.
이제 직접 해볼 차례입니다. 아래의 단계를 따라 프로젝트 폴더를 만들고 가상환경을 설정해 봅시다.
-
VSCode에서
파일(File)>폴더 열기(Open Folder)를 선택하고 Django 작업을 할 폴더를 선택합니다. -
VSCode에서 터미널을 엽니다. (Ctrl + ` 또는 Terminal > New Terminal)
-
Window는 터미널이 열리면 오른쪽 상단에 '+' 버튼 옆에 있는 아래쪽 화살표(▼)를 클릭합니다. 드롭다운 메뉴에서
PowerShell을 선택합니다. Mac은 기본으로 열리는 Terminal을 사용하셔도 좋습니다. 이 터미널을 통해 명령어를 실행할 것입니다. -
터미널에서 다음 명령어를 실행하여 프로젝트 폴더를 생성(
mkdir명령)하고 이동(cd명령)합니다.mkdir 01_3_basic cd 01_3_basic -
다음 명령어를 실행하여 가상환경을 생성합니다.
python -m venv [가상환경이름]형식입니다. 여기에서는 venv라는 이름으로 가상환경을 생성합니다. venv는 virtual environment의 약자입니다.python -m venv venv -
다음 명령어를 실행하여 가상환경을 활성화합니다. 이 가상환경속으로 들어간다고 생각하시면 됩니다.
-
Windows(2개 중 작동하는 것 하나만 입력합니다.)
.\venv\Scripts\activate .\venv\Scripts\activate.bat -
macOS/Linux
source ./venv/bin/activate
-
-
앞에
(venv)표시가 있는 상태에서만 작업을 진행해야 합니다. venv가 바로 활성화된 가상환경입니다.(venv) C:\Users\YourName\projects\01_3_basic>
보안 오류 해결 방법
Windows에서 다음과 같은 보안 오류가 발생할 경우 해결 방법입니다.

-
Windows 검색창에 PowerShell을 검색합니다.
-
관리자 권한으로 실행을 선택합니다.
-
다음 명령어를 입력해주세요. 복사하셔서 마우스 우클릭으로 붙여넣기를 하시면 됩니다.
Set-ExecutionPolicy Unrestricted
-
선택지가 뜹니다.
모두 예인A를 입력합니다.
-
VSC를 다시 실행하고 터미널을 열어주세요. 가상환경만 다시 실행해도 되지만 초급자에게는 VSC를 다시 실행하는 것이 더 편합니다.
2. Django 설치 및 프로젝트 생성
가상환경이 준비 되었다면, Django를 설치하고 첫 프로젝트를 생성해봅시다.
-
가상환경이 활성화된 상태에서 Django를 설치합니다.
pip install django -
Django 프로젝트를 생성합니다.
django-admin startproject [프로젝트이름] .형식입니다. 여기에서는config라는 이름으로 프로젝트를 생성합니다. 보통은 설정 파일이 프로젝트 이름 하위에 들어가기 때문입니다. 프로젝트 이름은 원하는 이름으로 변경하셔도 됩니다.django-admin startproject config .명령어 끝의 점(.)은 현재 디렉토리에 프로젝트를 생성한다는 의미입니다.
-
python 코드으로 짠 코드를 DB에 반영합니다. 지금은 초기 세팅 값으로 DB를 생성한다고 생각하시면 됩니다. 이 작업이 끝나면 sqlite3라는 DB가 생성됩니다.
python manage.py migrate실무에서는 migrate을 User 등의 초기 세팅이 모두 끝나고 합니다. 지금처럼 처음에 migrate를 처음에 하면 기본적으로 django에서 세팅해주는 기본 소스코드를 DB에 생성, 반영합니다.
-
개발 서버를 실행합니다.
python manage.py runserver -
웹 브라우저에서
http://127.0.0.1:8000/로 접속하여 아래와 같은 메인 페이지를 확인합니다.
개발 서버는 코드 변경을 자동으로 감지하고 서버를 재시작합니다. 서버를 중지하려면 터미널에서 Ctrl+C를 누르세요.
아래는 Django 프로젝트 생성 과정을 요약한 것입니다.