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