기술블로그-Django편

📌 Django 개발자를 위한 PyCharm 환경설정 꿀팁 (Mac & Windows 버전 구분)

Chansman 2025. 5. 8. 11:49

📌 Django 개발자를 위한 PyCharm 환경설정 꿀팁 (Mac & Windows 버전 구분)


✅ 1. 프로젝트 생성 시 Django 옵션 체크

  • File → New Project 선택
  • 왼쪽에서 Python → Django 선택
  • Create 전에 아래 항목을 설정:
    • Django support 체크
    • Template language: Django Template
    • Enable admin site 체크
    • 가상환경 선택: venv, poetry, pyenv 등 가능

✅ 2. Django 설정 자동 인식시키기

settings.py를 PyCharm이 Django 설정으로 인식하게 해야 여러 기능이 제대로 작동합니다.

설정 방법:

  • File → Settings (Windows) 또는 PyCharm → Preferences (Mac)
  • Languages & Frameworks → Django
  • 체크박스 선택: Enable Django Support
  • settings.py 경로 지정
  • manage.py 경로 지정
  • Apply / OK

✅ 3. 가상환경(Python interpreter) 연결

  • 경로: File → Settings (Windows) / PyCharm → Preferences (Mac)
  • Project: ... → Python Interpreter
  • 오른쪽 상단 톱니바퀴 클릭 → Add
  • 아래 중 선택:
    • Existing environment (기존 venv)
    • Conda, Poetry, Pipenv 등 지원

✅ 4. 단축키 차이 (Mac vs Windows)

기능 macOS Windows

찾기 Command + F Ctrl + F
바꾸기 Command + R Ctrl + R
전체 찾기 Shift + Command + F Ctrl + Shift + F
실행 Control + R Shift + F10
디버그 Control + D Shift + F9
정의로 이동 Command + B Ctrl + B 또는 Ctrl + 클릭
코드 포맷팅 Option + Command + L Ctrl + Alt + L
커맨드 검색 Shift + Command + A Ctrl + Shift + A
터미널 열기 Option + F12 Alt + F12

✅ 5. Django 템플릿 자동완성 활성화

  • 템플릿 디렉토리가 settings.py → TEMPLATES['DIRS']에 등록되어 있어야 함
  • File → Settings → Languages & Frameworks → Django → Templates folder에 해당 폴더 추가
  • {% url %}, {% block %} 자동완성, 인자 추적 활성화됨

✅ 6. 모델-마이그레이션 연동 및 힌트

  • 모델 클래스 작성 시, 빨간 줄 또는 회색 글씨가 나오면:
    • Alt + Enter (Windows) / Option + Return (Mac) → Create migration 자동 제안
    • 이 상태에서 makemigrations, migrate까지 GUI에서 실행 가능

✅ 7. 추천 추가 설정

  • Editor → Code Style → Python → 들여쓰기, 정렬, 공백 조절
  • Version Control → Git 연동 설정 (자동 Commit, Push 설정 가능)
  • Keymap에서 자주 쓰는 단축키 커스터마이징
  • Plugins → Django, GitLens, Material Theme 등 설치 가능

✅ 마무리 요약

기능 설정 위치 목적

Django Support Preferences → Django 템플릿, view, model 자동 인식
가상환경 연결 Preferences → Interpreter 패키지 설치, 실행 환경 설정
템플릿 자동완성 Django → Templates 폴더 지정 HTML에서 {% %} 자동완성 활성화
단축키 Keymap 또는 요약표 개발 속도 향상
Git 연동 Version Control → Git 협업/백업을 위한 기본 설정

💡 PyCharm은 Django와 최고의 궁합을 자랑하는 IDE입니다.
설정만 잘 해두면 개발 속도와 안정성이 확 올라갑니다!

다음에는 Django + Docker 프로젝트에서 PyCharm 연동 팁도 정리해드릴게요.