🖥️ PyCharm WSL Interpreter 설정 오류 해결 방법
✅ 설정 방법
- File → Settings → Project: (프로젝트명) → Python Interpreter → Add Interpreter
- WSL 선택 후 Python 경로 수동 입력
/home/사용자명/.pyenv/versions/3.12.2/bin/python
⚠️ 문제 상황
- PyCharm에서 WSL Interpreter를 자동으로 인식하지 못함
- "No interpreter found", "Invalid interpreter" 오류 발생
- 터미널 기본 셸이 PowerShell로 되어 있어 경로 충돌 발생
- WSL 내부 pyenv Python 가상환경이 Interpreter 목록에 표시되지 않음
🔥 해결 방법
1. Interpreter 수동 추가
- Add Interpreter → WSL 선택 → 직접 Python 경로 입력
/home/사용자명/.pyenv/versions/3.12.2/bin/python
2. 터미널 셸 경로 수정
- File → Settings → Tools → Terminal → Shell Path 수정
wsl.exe -d Ubuntu-22.04 zsh
3. PyCharm 재시작
- 설정 완료 후 PyCharm 전체 종료 후 재실행
4. WSL 배포판 확인
- WSL 터미널에서 배포판 확인
wsl -l -v
- 정확한 이름을 기반으로 Interpreter 설정 적용
5. pyenv 재설정
- 터미널에서 pyenv 글로벌 버전 재설정
pyenv rehash
pyenv global 3.12.2
6. Interpreter 새로고침
- Interpreter 설정 화면에서 Refresh 버튼 클릭
🎯 최종 확인 사항
- PyCharm 상단 Python Interpreter가 정상 표시되는지 확인
- 터미널에서 python --version이 3.12.2로 출력되는지 확인
- 새 프로젝트 생성 시에도 설정한 Interpreter가 기본 적용되는지 점검
📌 추가 팁
- .idea 폴더를 삭제 후 프로젝트를 다시 열어 초기화하는 방법도 있음
- Nerd Font 적용 및 p10k 설정을 통해 터미널 가독성을 높이는 것 추천
'기술블로그-Django편' 카테고리의 다른 글
✅ Python 환경 설정부터 Django 설치 (feat. pyenv, Pycharm, Poetry) (0) | 2025.04.29 |
---|---|
Poetry란? 설치방법 및 pyenv와 차이점 (0) | 2025.04.29 |
📌 PyCharm을 명령줄에서 실행할 수 있도록 설정하기 (Windows 환경 + WSL 연동 포함) (0) | 2025.04.29 |
📚 WSL 전체 세팅 과정 정리 (0) | 2025.04.29 |
pyenv와 venv의 차이 및 충돌 상황 정리 (Windows 기준) (0) | 2025.04.29 |