Django 프레임워크 가상환경에서 개발하기

📌 Django 프로젝트 설정 및 실행 가이드

---

1. 디렉터리 및 가상 환경 설정

✅ D 드라이브 구조

D 드라이브
├── DjangoProject (최상위 폴더)
│   ├── djangosite (Django 프로젝트 폴더)
│   │   ├── config (설정(Configuration)을 관리하는 모듈)
│   │   ├── movies (Django 앱)
│   │   ├── coffees (Django 앱)
│   ├── virdir (가상 환경 폴더)
│       ├── virenv (가상 환경)

📌 앱(App)이란?

• Django에서 특정한 기능이나 역할을 수행하는 독립적인 모듈입니다.
• 예를 들어, movies 앱은 영화 관련 기능을 담당하고, coffees 앱은 커피 관련 기능을 수행할 수 있습니다.

---

2. 가상 환경 생성

가상 환경을 사용하면 Django 및 필요한 패키지들을 프로젝트별로 격리하여 관리할 수 있습니다.

✅ 가상 환경 폴더 생성

d:
cd \
mkdir virdir
cd virdir

📌 virdir 폴더를 만들고, 그 안으로 이동합니다.

✅ 가상 환경 생성

python -m venv virenv

📌 virenv라는 가상 환경이 생성됩니다.

📌 명령어 설명

• python → 현재 시스템에 설치된 Python 인터프리터 실행
• -m venv → Python의 venv 모듈을 사용하여 가상 환경 생성
• virenv → 생성할 가상 환경의 이름 (폴더명)

---

3. 가상 환경 진입 및 종료

✅ 가상 환경 진입

cd d:\virdir\virenv\Scripts
activate

📌 가상 환경에 성공적으로 진입하면 프롬프트 앞에 (virenv) 표시가 나타납니다.

(virenv) d:\virdir\virenv\Scripts>

✅ 가상 환경 빠져나가기

deactivate

📌 deactivate를 실행하면 가상 환경에서 벗어납니다.

✅ 가상 환경 빠져나가기

---

4. Django 설치 및 확인

✅ 가상 환경 활성화 후 Django 설치

pip install django==3.1.3

📌 반드시 가상 환경을 활성화한 후 실행해야 합니다(activate 명령어를 실행한 상태).

✅ Django 설치 확인

pip list

또는

dir

📌 pip list → 설치된 Python 패키지 목록을 확인
📌 dir → 현재 디렉터리에 Django 관련 파일이 있는지 확인
📌 Django가 목록에 나타나면 정상적으로 설치된 것입니다.

---

5. Django 프로젝트 생성 후 파일 구조 확인

✅ 루트 디렉터리 생성

cd \
mkdir DjangoProject
cd DjangoProject
mkdir djangosite
cd djangosite

📌 DjangoProject 폴더를 만들고, 그 안에서 djangosite 디렉터리를 생성합니다.

✅ Django 프로젝트 시작

django-admin startproject config .

📌 Django 프로젝트를 시작할 때 사용하는 명령어입니다.
📌 config .에서 .(점)은 현재 디렉터리를 의미하며, 새로운 폴더를 생성하지 않고 현재 디렉터리에 Django 프로젝트 파일을 생성합니다.
📌 띄어쓰기를 하지 않으면 config라는 폴더가 따로 생성될 수 있습니다.

명령어 요소	설명
django-admin	Django 프로젝트를 관리하는 명령어 도구
startproject	새로운 Django 프로젝트를 생성
config	프로젝트 이름 (생성될 디렉터리 또는 설정 폴더)
. (점)	현재 디렉터리에 프로젝트 파일을 생성

✅ 프로젝트 파일 구조 확인

dir /b/s

📌 dir 명령어 옵션

명령어	설명	출력 예시
dir	기본 파일 및 폴더 목록 출력 (날짜, 크기 포함)	2024-03-14 12:30 12,345 myfile.txt
dir /b	간단한 목록 (파일명과 폴더명만 표시)	myfile.txt subfolder
dir /s	하위 폴더까지 포함하여 목록 출력	C:\project\subfolder\file.txt
dir /b/s	하위 폴더 포함 + 파일 경로만 출력 (깔끔한 리스트)	C:\project\file.txt C:\project\subfolder\file2.txt

📌 추가 옵션

옵션	설명
/a	숨김 파일 포함
/o	정렬 (이름순, 날짜순 등)
/t	파일 시간 표시 (생성, 수정 등)
/p	페이지별 출력 (한 화면씩 보기)

---

6. Django 개발 서버 실행

✅ 서버 실행

python manage.py runserver

📌http://127.0.0.1:8000/ 에서 Django 서버가 실행됩니다.
📌 서버를 종료하려면 Ctrl + C 를 누르시면 됩니다.

---

7. 배치 파일 생성 (appstart.cmd)

✅ 배치 파일(.cmd)을 만들어 Django 프로젝트를 자동으로 실행

📌 다음 내용을 appstart.cmd 파일로 저장합니다.

@echo off
d:
cd d:\DjangoProject\djangosite
D:\virdir\virenv\Scripts\activate

📌 @echo off는 배치 파일 실행 시 명령어 자체를 화면에 출력하지 않도록 설정합니다.

✅ 배치 파일 실행

appstart

📌 새로운 cmd 창에서 실행하면 자동으로 가상 환경을 활성화하고 Django 프로젝트 폴더로 이동합니다.

---

8. 개발 툴에서 Django 프로젝트 설정

1️⃣ 개발 툴(VSCode, PyCharm 등)에서 프로젝트를 엽니다.
2️⃣ Python 인터프리터를 가상 환경의 python.exe로 변경합니다.

• 경로 예시: D:\virdir\virenv\Scripts\python.exe
  3️⃣ 가상 환경 확인

   pip list

  📌 Django가 설치된 것을 확인합니다.
  📌 가상 환경에 인터프리터 설정을 다르게 했기 때문에 패키지가 다르게 나옵니다.

---

9. 새로운 앱(App) 생성

Django에서 앱은 특정한 기능을 담당하는 독립적인 모듈입니다.

✅ 앱 생성

django-admin startapp movies

📌 movies라는 Django 앱이 생성됩니다.

📌 앱이 정상적으로 동작하려면 INSTALLED_APPS에 등록해야 합니다.
📌 config/settings.py에서 다음과 같이 추가합니다.

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'movies',  # 새로 만든 앱 등록
]

---

10. pip 패키지 업그레이드

✅ pip 최신 버전으로 업그레이드

python.exe -m pip install --upgrade pip

📌 최신 패키지를 설치하고 관리할 수 있도록 pip를 업데이트합니다.

---

11. 가상환경, Django 다시 실행 방법

✅ 1) 관리자 권한으로 CMD 실행

• CMD(명령 프롬프트)를 관리자 권한으로 실행합니다.
• "CMD"를 검색한 후 "관리자 권한으로 실행"을 선택합니다.

✅ 2) 가상 환경 활성화 (appstart.cmd 실행)

appstart

📌 이 명령어를 실행하면 자동으로 다음 작업이 수행됩니다.
1️⃣ D 드라이브로 이동 (d:)
2️⃣ Django 프로젝트 폴더로 이동 (cd d:\DjangoProject\djangosite)
3️⃣ 가상 환경 활성화 (D:\virdir\virenv\Scripts\activate)

📌 성공 시 프롬프트에 (virenv)가 표시됩니다.

(virenv) d:\DjangoProject\djangosite>

✅ 이제 가상 환경이 활성화된 상태입니다.

✅ 3) Django 개발 서버 실행

가상 환경이 활성화된 상태에서 다음 명령어를 입력하여 Django 서버를 실행합니다.

python manage.py runserver

📌 Django 서버가 실행되면 기본적으로 http://127.0.0.1:8000/ 에서 접근 가능합니다.
📌 서버를 종료하려면 Ctrl + C를 누르면 됩니다.

---

12. 추가 개념 정리

✅ 폴더와 디렉터리의 차이

• 폴더(GUI 환경): 그래픽 인터페이스에서 사용
• 디렉터리(CLI 환경): 명령줄에서 사용

✅ CMD에서 폴더/파일 자동 완성

• Tab 키를 누르면 자동 완성 기능을 사용할 수 있습니다.
• 예: cd D:\Djang → Tab → cd D:\DjangoProject

✅ 배치 처리(Batch Processing)

• 여러 작업(파일 변환, 데이터 처리, 백업 등)을 한 번에 실행하는 방식입니다.
• appstart.cmd 같은 배치 파일을 만들어 자동화할 수 있습니다.

---

📌 최종 정리

✅ Django 프로젝트 설정 및 실행 흐름
1️⃣ 가상 환경 생성 (python -m venv virenv)
2️⃣ 가상 환경 활성화 (activate)
3️⃣ Django 설치 (pip install django)
4️⃣ 프로젝트 생성 (django-admin startproject config .)
5️⃣ 서버 실행 (python manage.py runserver)
6️⃣ 배치 파일(appstart.cmd)을 생성하여 자동 실행
7️⃣ 개발 툴에서 Python 인터프리터 설정
8️⃣ 새로운 앱 생성 (django-admin startapp [앱이름])