✅ PyCharm에서 Django URL, static 경로 오류가 날 때 확인할 것!

✅ PyCharm에서 Django URL, static 경로 오류가 날 때 확인할 것!

---

🧩 발생한 문제

• {% static '...' %}
• {% url '...' %}

PyCharm에서 위와 같은 Django 템플릿 문법들이 다음과 같은 경고를 발생시켰다:

"해결할 수 없습니다" 또는 "경로를 찾을 수 없습니다"

하지만 서버는 정상 작동하고 브라우저에서도 문제 없음 → 에디터(Pycharm)가 Django 프로젝트로 인식 못하는 것이 원인.

---

🧨 원인 정리

PyCharm에서 Django 지원이 비활성화된 상태였기 때문!

PyCharm은 기본적으로 HTML 문법만 인식하고, Django 템플릿 문법은 따로 설정해줘야 인식한다.

복사하거나 새로 만든 프로젝트일수록 Django 지원 설정이 빠져있을 확률 높음

---

✅ 해결 방법

1. Django 지원 활성화

• 메뉴: File → Settings → Languages & Frameworks → Django
• 아래 항목 설정:
  • Django 지원 활성화
  • Django 프로젝트 루트 → chapter_06/ (즉, manage.py가 있는 폴더)
  • 설정 → chapter_06/config/settings.py
  • Manage.py 작업 → chapter_06/manage.py

2. 템플릿 언어 지정

• .html 파일 우측 하단 상태바 → "HTML" → 클릭 → Django Template 선택

---

🔍 그 외 체크리스트

항목 내용

템플릿 파일 경로	templates/ 폴더가 settings.py에 제대로 잡혀 있어야 함
static 설정	STATICFILES_DIRS에 BASE_DIR / 'static' 설정 필요
url 오류	urls.py에 name='...'이 실제로 존재하는지 확인
네임스페이스	app_name이 있다면 {% url '앱이름:뷰이름' %}로 호출해야 함

---

🧠 실전 팁

• 새로운 Django 프로젝트를 만들거나 복사했을 때, 가장 먼저 PyCharm Django 설정부터 확인하자
• 경고가 떠도 서버가 잘 동작하면 당황하지 말고 설정을 먼저 점검해보자
• Django 지원 설정만 제대로 하면 자동완성, 인식, 추적 기능까지 한 번에 해결된다

---

💬 결론

PyCharm에서 {% static %}이나 {% url %} 경로 오류가 뜰 땐 대부분 "Django 지원 꺼짐" 문제다.
설정 한 번만 제대로 하면 앞으로는 동일 실수 없이 쾌적한 Django 개발 가능! ✅