Django 포트폴리오 만들기 ① uv 설치부터 기본 설정까지

이번엔 Django로 

포트폴리오 홈페이지를 만들어보는 실습을 진행했어요. 

패키지 매니저로는 pip 대신 uv를 사용했는데, 

확실히 설치 속도가 빠르고 명령어도 직관적이라 편했습니다.

이번 편은 

① uv로 Django 설치 

② 기본 세팅(언어/시간대)

③ 관리자 계정 생성까지만 다루고, 

PRD 기반으로 실제 페이지 내용을 채우는 과정은 다음 편에서 이어갈게요!

---

1. uv로 Django 설치하기

Django를 설치하는 방법은 두 가지로 해봤어요. 

하나는 커서AI에게 직접 요청하는 방법, 

다른 하나는 명령어를 제가 직접 입력하는 방법이에요.

① 커서AI에게 요청하는 방법

"uv(패키지 매니저)를 사용해서 현재 폴더에 장고를 설치해줘!"

설치가 끝나면 이어서 "설정해줘"라고 요청하면 기본 세팅까지 진행해줘요.

② 직접 명령어로 설치하는 방법

먼저 설치할 폴더로 이동해요. 저는 website_django라는 폴더로 설정했어요.

명령어	mkdir D:\cursorai\website_django cd D:\cursorai\website_django

폴더 이동 후 아래 명령어를 순서대로 입력하면 돼요.

순서	명령어	설명
1	uv init .	프로젝트 초기화
2	uv add django	Django 설치
3	uv run django-admin startproject config .	Django 프로젝트 생성
4	uv run python manage.py runserver	개발 서버 실행

▲ uv init → uv add django → startproject → runserver까지 순서대로 실행한 터미널 화면

💡 Tip. 나중에 앱을 추가할 때도 uv run python manage.py startapp blog처럼 항상 uv run을 붙여서 실행하면 돼요. uv가 관리하는 가상환경 안에서 명령어가 실행되도록 하는 거예요.

2. 언어 / 시간대 설정하기

Django 프로젝트를 처음 만들면 

기본 언어와 시간대가 영어/UTC로 되어 있어요. 

 한국어와 한국 시간대로 바꾸는 방법도 두 가지가 있어요.

① AI에게 요청하기

"한국말, 한국 시간대로 변경해줘"

② 직접 설정 파일 수정하기

config 폴더 안의 settings.py 파일 맨 하단 부분을 아래처럼 바꾸면 돼요.

파일	config/settings.py
수정 내용	LANGUAGE_CODE = 'ko-kr' TIME_ZONE = 'Asia/Seoul'

▲ settings.py 하단에서 LANGUAGE_CODE, TIME_ZONE 설정 확인

3. DB 활성화 & 관리자 계정 만들기

설정이 끝났으면 DB 테이블을 활성화해줘야 해요.

명령어	uv run python manage.py migrate

이어서 관리자 계정을 생성해요.

명령어	uv run python manage.py createsuperuser

실행하면 사용자 이름, 이메일 주소, 패스워드, 패스워드 확인을 순서대로 입력하라고 나와요.

💡 Tip. 패스워드를 입력할 때 화면에 아무것도 안 보여서 당황했는데, 보안상 입력값이 표시되지 않는 거였어요. 그냥 동일하게 두 번 입력하면 됩니다. "Superuser created successfully" 메시지가 뜨면 성공이에요.

4. 서버 실행 & 관리자 페이지 확인

관리자 계정까지 만들었으면 다시 서버를 실행해서 확인해봐요.

명령어	uv run python manage.py runserver

서버 주소(http://127.0.0.1:8000/)로 접속하면 기본 화면이 뜨고, 

http://127.0.0.1:8000/admin으로 들어가서 

아까 만든 관리자 이름과 패스워드를 입력하면 

관리자 페이지에 접속할 수 있어요.

▲ Django 관리자 페이지. 기본적으로 인증 및 권한(그룹, 사용자) 메뉴가 제공됨

따로 뭘 만들지 않았는데도 "인증 및 권한" 아래 

그룹, 사용자 메뉴가 이미 생성되어 있는 걸 볼 수 있어요. 

Django가 기본으로 제공해주는 기능이에요.

---

오늘의 정리

• Django 설치는 pip 대신 uv로 진행 — uv init → uv add django → startproject 순서
• 명령어 실행할 땐 항상 앞에 uv run을 붙여야 함 (앱 생성 시에도 동일)
• 언어/시간대는 settings.py 하단의 LANGUAGE_CODE, TIME_ZONE 값으로 변경
• DB 활성화는 migrate, 관리자 계정은 createsuperuser로 생성
• 패스워드 입력 시 화면에 표시가 안 되는 게 정상 — 두 번 동일하게 입력하면 됨
• 관리자 페이지(/admin)엔 그룹, 사용자 메뉴가 기본으로 제공됨

다음 편에서는 Next.js 작업할 때 썼던 PRD 문서를 Django용으로 변환해서, 

실제 포트폴리오 페이지 내용을 채워 넣는 과정을 정리해볼게요! 🙌