리눅스 환경에서 VS Code로 Django 프로젝트 개발하기

리눅스 환경에서 VS Code로 Django 프로젝트 개발하기

1. Visual Studio Code 설치

리눅스에서는 터미널 명령어로 설치할 수 있습니다.

(1) Microsoft 저장소 추가

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/

(2) VS Code 저장소 등록

sudo sh -c 'echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'

(3) 설치

sudo apt update
sudo apt install code

설치가 끝나면 명령어로 VS Code를 실행할 수 있습니다:

code

2. 필수 확장 프로그램 설치

VS Code를 열고, 왼쪽의 '확장(Extensions)' 탭에서 다음을 설치합니다.

• Python (Microsoft 제공)
• Django (템플릿 지원용)

팁:
Ctrl + Shift + X를 눌러 확장 탭을 열고, Python, Django를 검색해서 설치하면 됩니다.

3. Django 프로젝트 열기

• [파일] → [폴더 열기] 메뉴를 선택합니다.
• 본인이 만든 Django 프로젝트 폴더(manage.py 파일이 있는 폴더)를 선택합니다.

4. Python 가상환경 설정

리눅스에서는 **Python 가상환경(venv)**을 꼭 설정해 사용하는 것이 좋습니다.

(1) 가상환경 생성

프로젝트 폴더 안에서 터미널을 열어 다음을 입력합니다.

python3 -m venv venv

(2) 가상환경 활성화

source venv/bin/activate

활성화되면 터미널 앞에 (venv)가 표시됩니다.

(3) VS Code에서 가상환경 선택

• 왼쪽 아래 Python 버전 표시 부분을 클릭합니다.
• (venv) 폴더 안의 Python을 선택합니다.
  (예: /home/사용자명/프로젝트명/venv/bin/python)

5. Django 서버 실행

가상환경이 활성화된 상태에서 터미널에 입력합니다.

python manage.py runserver

• 정상적으로 실행되면 http://127.0.0.1:8000로 접속할 수 있습니다.

6. VS Code의 개발 편의 기능

• 자동완성 : models.py, views.py 작성 시 추천 코드 지원
• 오류 탐색 : 코딩 에러가 발생하면 정확한 위치를 표시
• 파일 관리 : settings.py, urls.py 등을 여러 탭으로 열어 편집 가능
• 통합 터미널 : VS Code 내부에서 바로 명령어 실행 가능

---

정리

1	리눅스에 VS Code 설치 (apt 사용)
2	Python, Django 확장 설치
3	프로젝트 폴더 열기
4	가상환경 생성 및 활성화
5	VS Code에서 가상환경 선택
6	runserver로 Django 서버 구동
7	VS Code 기능 활용 (자동완성, 터미널 등)

단계 설명

---

주의사항

• 리눅스에서는 항상 python 대신 python3, pip 대신 pip3를 사용하는 경우가 많습니다.
• 가상환경을 활성화하지 않으면 Django 명령어(manage.py)가 정상 작동하지 않을 수 있습니다.
• 가상환경은 프로젝트마다 별도로 만들어야 관리가 편합니다.

---