기술블로그

🖥️ 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 설정을 통해 터미널 가독성을 높이는 것 추천