기술블로그
🖥️ PyCharm WSL Interpreter 설정 오류
Chansman
2025. 4. 29. 15:51
🖥️ 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 설정을 통해 터미널 가독성을 높이는 것 추천