01공식문서를 통한 장고 설치 | ✅저자: 이유정(박사)

📖 공식 문서 링크:
🔗 https://docs.djangoproject.com/ko/5.2/intro/install/

✨ CLI(Command Line Interface) : 명령줄 인터페이스로, 사용자가 터미널에 직접 텍스트 명령어를 입력하여 컴퓨터와 상호작용하는 방식입니다.
GUI(그래픽 사용자 인터페이스)와 달리 마우스 없이 명령어만으로 작업을 수행합니다.

✅ 작업용 폴더 만들기

mkdir Django_first
cd Django_first
python3 -m venv venv
source venv/bin/activate
pip install django

# 디렉토리 삭제가 필요한 경우
deactivate # (가상환경 안에 있을 경우 먼저 비활성화)
cd ~/your_project # 가상환경이 있는 폴더로 이동
rm -rf venv # 가상환경 삭제

✅ 1단계. Python 설치 확인 Django는 Python 기반이므로, 먼저 Python이 설치되어 있어야 합니다.

# 설치된 파이썬 버전확인
python --version

What Python version can I use with Django? https://docs.djangoproject.com/en/5.2/faq/install/#what-python-version-can-i-use-with-django

✅ 2단계. 가상환경(Virtual Environment) 만들기

# 경로확인
(venv) youjung@DESKTOP-PJCRMMU:~/Django_OfficialDocumentTutorial/

python -m venv venv  # 가상환경 생성

# 잘못만들어진 가상환경 지우기
rm -rf venv

source venv/bin/activate   # macOS/Linux
myenv\Scripts\activate      # Windows

https://docs.djangoproject.com/ko/5.2/howto/windows/#using-python-s-venv

가상환경 재생성

# 가상환경 폴더 삭제
rm -rf venv

# 새로 가상환경 생성 (Python 3.x 버전에 맞게)
python3 -m venv venv

# 가상환경 활성화
source venv/bin/activate

# pip 최신화
pip install --upgrade pip

# Django 설치
pip install django

# requirements.txt 파일 기반으로 패키지 설치
pip install -r requirements.txt

pip list

✅ 3단계. Django 설치: 반드시 가상환경 안에서 장고를 install합니다.

pip install django

https://docs.djangoproject.com/ko/5.2/intro/install/#install-django

🧐설치확인

python -m django --version

🧾 보충설명: 장고 프로젝트를 새로 개발할때마다 가상환경안에 장고를 새로 설치합니다.

✅ 4단계. Django 프로젝트 시작

django-admin startproject mysite . [전체 플랫폼 또는 서비스의 이름]
cd mysite # 생성된 플랫폼 폴더로 이동

◽ 프로젝트 구조는 다음과 같습니다:

├── manage.py
├── mysite/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   ├── wsgi.py
│   └── asgi.py

✅ 5단계. 개발 서버 실행: 서버 주소: http://127.0.0.1:8000/

python manage.py runserver