1️⃣ 가상환경 실행
Django 프로젝트를 시작하기 전에 먼저 Python 가상환경을 활성화해야 한다.
가상환경을 사용하면 프로젝트별로 독립적인 Python 실행 환경을 만들 수 있고, 라이브러리 충돌을 방지할 수 있다.
- MAC / Linux: source .hello_world/bin/activate
- Windows: source .hello_world/Scripts/activate
가상환경이 활성화되면 보통 터미널 앞에 다음과 같이 표시된다.
- (.hello_world)
이 상태에서 설치하는 라이브러리는 해당 가상환경에만 적용된다.
2️⃣ Django 설치
가상환경을 활성화한 후 pip를 이용해 Django를 설치한다.
- pip install django
설치가 완료되면 Django가 정상적으로 설치되었는지 버전을 확인할 수 있다.
- django-admin --version
3️⃣ Django 프로젝트 생성
Django 프로젝트는 다음 명령어로 생성할 수 있다.
- django-admin startproject config hello_world
여기서 각 인자의 의미는 다음과 같다.
| 항목 | 설명 |
| config | Django 프로젝트 설정 폴더 이름 |
| hello_world | 프로젝트 루트 디렉토리 |
→ `hello_world` 디렉토리를 만들고 그 안에 `config` Django 프로젝트를 생성한다.
▶️ startproject 기본 사용법
기본 명령어는 다음과 같다.
- django-admin startproject {프로젝트 이름}
하지만 이 경우 다음과 같이 같은 이름의 디렉토리가 두 개 생긴다.
hello_world
├ hello_world
│ ├ __init__.py
│ ├ settings.py
│ ├ urls.py
│ ├ asgi.py
│ └ wsgi.py
└ manage.py
그래서 보통 다음 방식으로 프로젝트를 생성한다.
- django-admin startproject config hello_world
이렇게 하면 다음처럼 설정 폴더 이름과 프로젝트 폴더를 분리할 수 있다.
hello_world
├ config
│ ├ __init__.py
│ ├ settings.py
│ ├ urls.py
│ ├ asgi.py
│ └ wsgi.py
└ manage.py
4️⃣ Django 서버 실행
프로젝트 생성 후 서버를 실행하려면 다음 명령어를 사용한다.
- python manage.py runserver
서버가 정상적으로 실행되면 다음과 같은 메시지가 출력된다.
브라우저에서 해당 주소로 접속하면 Django 기본 페이지를 확인할 수 있다.
5️⃣ Django 프로젝트 기본 파일
Django 프로젝트를 생성하면 몇 가지 기본 파일들이 자동으로 만들어진다.
manage.py
Django 명령어를 실행하기 위한 파일이다.
- python manage.py runserver
- python manage.py migrate
- python manage.py createsuperuser
settings.py
Django 프로젝트의 전체 설정을 관리하는 파일이다.
- 데이터베이스 설정
- 앱 등록
- 보안 설정
- 템플릿 설정
urls.py
URL과 View를 연결하는 라우팅(Routing) 을 담당하는 파일이다.
urlpatterns = [
path("admin/", admin.site.urls),
]
📘 정리
Django 프로젝트를 시작하는 기본 흐름은 다음과 같다.
- 가상환경 활성화
- Django 설치
- Django 프로젝트 생성
- 개발 서버 실행
[참고] 실전! Django 입문 강의