Django 프로젝트 구조 설정 가이드 (VS Code 사용)
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
웹 개발
대상자
- 초보자 및 중급 개발자
- Python 3.13 이상, Django 프레임워크 사용자
- 확장 가능한 웹 애플리케이션 개발을 목표로 하는 개발자
핵심 요약
- 가상 환경 설정 (
virtualenv
활용)은 의존성 고립을 위해 필수 (python -m venv env
) - Django 프로젝트 생성은
django-admin startproject
명령어로 구현 - 앱 구조는
config/
,apps/
,templates/
폴더 분리하여 모듈화 (예:blog/
,portfolio/
)
섹션별 세부 요약
1. 프로젝트 폴더 생성
mkdir my_django_project
명령어로 폴더 생성- VS Code에서 폴더 열기 및 파일 구조 초기화
2. 가상 환경 설정
python -m venv env
명령어로 가상 환경 생성env\Scripts\activate
(Windows) 또는source env/bin/activate
(Unix) 명령어로 활성화
3. Django 설치
pip install django
명령어로 설치- 설치 완료 후
python manage.py runserver
로 서버 실행
4. Django 프로젝트 생성
django-admin startproject
명령어로 프로젝트 생성- 생성된 폴더 구조:
config/
,manage.py
,env/
5. 앱 생성
python manage.py startapp
명령어로 앱 생성 (예:blog
,portfolio
)- 앱별 폴더 구조:
templates/
내app_name/
하위 폴더 생성
6. 모델 정의
- 앱별
models.py
파일에서 데이터베이스 모델 정의 views.py
와urls.py
에서 뷰 및 URL 라우팅 연결
7. URL 설정
urls.py
파일에서path()
함수로 뷰와 URL 매핑- 예:
path('about/', views.about, name='about')
8. HTML 템플릿 설정
templates/
폴더 내app_name/
하위 폴더에home.html
,projects.html
등 템플릿 파일 생성- 템플릿은
{% extends %}
태그로 재사용 가능
결론
- 가상 환경 사용을 통해 의존성 충돌 방지
- 앱별 폴더 구조 (
config/
,apps/
,templates/
)로 모듈화하여 확장성 향상 django-admin startproject
및startapp
명령어로 효율적인 프로젝트 초기화 가능