Python Django

Django 설치 및 가상 환경 설정 (pip install django)

PyExplorer 2025. 2. 20. 09:29
728x90

Django 설치 및 가상 환경 설정 (pip install django)

Django는 Python 기반의 강력한 웹 프레임워크로, 빠르고 효율적인 웹 애플리케이션 개발을 지원합니다. 이번 포스팅에서는 Django를 설치하는 방법과 Python의 가상 환경을 설정하는 방법을 단계별로 설명하겠습니다.

1. 가상 환경이란?

Python의 가상 환경(Virtual Environment)은 특정 프로젝트에서 사용하는 패키지들을 독립적으로 관리할 수 있도록 도와주는 기능입니다. 이를 통해 시스템 전역 환경을 오염시키지 않고, 프로젝트마다 별도의 패키지 버전을 유지할 수 있습니다.

2. Python 및 pip 확인

Django를 설치하기 전에 Python과 pip가 설치되어 있는지 확인해야 합니다. 터미널(또는 명령 프롬프트)에서 다음 명령어를 실행하세요.

python --version
pip --version

Python이 설치되어 있지 않다면, 공식 웹사이트에서 다운로드하여 설치해 주세요.

3. 가상 환경 생성 및 활성화

3.1 가상 환경 생성

Python에서는 venv 모듈을 사용하여 가상 환경을 생성할 수 있습니다. 원하는 프로젝트 폴더로 이동한 후, 다음 명령어를 실행하세요.

python -m venv myenv

여기서 myenv는 가상 환경의 이름이며, 원하는 이름으로 변경할 수 있습니다.

3.2 가상 환경 활성화

운영체제에 따라 가상 환경을 활성화하는 방법이 다릅니다.

  • Windows (cmd 또는 PowerShell 사용)
myenv\Scripts\activate
  • MacOS/Linux
source myenv/bin/activate

활성화되면 터미널 프롬프트 앞에 (myenv)와 같은 표시가 나타납니다.

4. Django 설치

가상 환경이 활성화된 상태에서 Django를 설치하려면 다음 명령어를 실행하세요.

pip install django

설치가 완료된 후 Django 버전을 확인하여 정상적으로 설치되었는지 확인할 수 있습니다.

django-admin --version

5. Django 프로젝트 생성

Django가 설치되었다면 새로운 프로젝트를 생성할 수 있습니다. 가상 환경이 활성화된 상태에서 다음 명령어를 실행하세요.

django-admin startproject myproject

myproject는 프로젝트의 이름이며, 원하는 이름으로 변경할 수 있습니다.

이제 myproject 폴더가 생성되었으며, 기본적인 Django 프로젝트 구조가 구성됩니다.

6. Django 개발 서버 실행

Django 프로젝트 폴더로 이동한 후, 개발 서버를 실행할 수 있습니다.

cd myproject
python manage.py runserver

정상적으로 실행되면 다음과 같은 메시지가 출력됩니다.

Starting development server at http://127.0.0.1:8000/

웹 브라우저에서 http://127.0.0.1:8000/에 접속하면 Django의 기본 화면을 확인할 수 있습니다.

7. 가상 환경 비활성화

작업이 끝난 후 가상 환경을 비활성화하려면 다음 명령어를 실행하세요.

deactivate

가상 환경을 비활성화하면 원래의 Python 환경으로 돌아갑니다.

8. 추가 패키지 설치 및 requirements.txt 관리

Django 프로젝트에서는 다양한 패키지를 사용할 수 있습니다. 추가적인 패키지를 설치할 때는 다음과 같이 실행하세요.

pip install <패키지명>

예를 들어, django-rest-framework를 설치하려면 다음과 같이 입력합니다.

pip install djangorestframework

설치한 패키지 목록을 requirements.txt 파일로 저장하려면 다음 명령어를 실행하세요.

pip freeze > requirements.txt

이후 다른 개발자가 동일한 패키지를 설치할 수 있도록 requirements.txt를 사용하여 패키지를 한 번에 설치할 수 있습니다.

pip install -r requirements.txt

9. 마무리

이번 포스팅에서는 Django를 설치하는 과정과 가상 환경을 설정하는 방법을 설명하였습니다. Django는 가상 환경을 활용하여 프로젝트마다 독립적인 개발 환경을 구성하는 것이 중요합니다.

728x90