🖥️ PyCharm WSL Interpreter 설정 오류

2025. 4. 29. 15:51·기술블로그-Django편
목차
  1. 1. Interpreter 수동 추가
  2. 2. 터미널 셸 경로 수정
  3. 3. PyCharm 재시작
  4. 4. WSL 배포판 확인
  5. 5. pyenv 재설정
  6. 6. Interpreter 새로고침

🖥️ 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
  1. 1. Interpreter 수동 추가
  2. 2. 터미널 셸 경로 수정
  3. 3. PyCharm 재시작
  4. 4. WSL 배포판 확인
  5. 5. pyenv 재설정
  6. 6. Interpreter 새로고침
'기술블로그-Django편' 카테고리의 다른 글
  • Poetry란? 설치방법 및 pyenv와 차이점
  • 📌 PyCharm을 명령줄에서 실행할 수 있도록 설정하기 (Windows 환경 + WSL 연동 포함)
  • 📚 WSL 전체 세팅 과정 정리
  • pyenv와 venv의 차이 및 충돌 상황 정리 (Windows 기준)
Chansman
Chansman
안녕하세요! 코딩을 시작한 지 얼마 되지 않은 초보 개발자 찬스맨입니다. 이 블로그는 제 학습 기록을 남기고, 다양한 코딩 실습을 통해 성장하는 과정을 공유하려고 합니다. 초보자의 눈높이에 맞춘 실습과 팁, 그리고 개발하면서 겪은 어려움과 해결 과정을 솔직하게 풀어내려 합니다. 함께 성장하는 개발자 커뮤니티가 되기를 바랍니다.
찬스맨의 프로그래밍 스토리안녕하세요! 코딩을 시작한 지 얼마 되지 않은 초보 개발자 찬스맨입니다. 이 블로그는 제 학습 기록을 남기고, 다양한 코딩 실습을 통해 성장하는 과정을 공유하려고 합니다. 초보자의 눈높이에 맞춘 실습과 팁, 그리고 개발하면서 겪은 어려움과 해결 과정을 솔직하게 풀어내려 합니다. 함께 성장하는 개발자 커뮤니티가 되기를 바랍니다.
  • Chansman
    찬스맨의 프로그래밍 스토리
    Chansman
  • 전체
    오늘
    어제
    • 분류 전체보기 (794) N
      • Python (32)
      • 프로젝트 (113)
      • 과제 (25)
      • Database (40)
      • 멘토링 (11)
      • 특강 (37)
      • 기술블로그 (41)
      • 기술블로그-Fastapi편 (33)
      • 기술블로그-Django편 (154) N
      • 기술블로그-Flask편 (36)
      • AI 분석 (5)
      • HTML & CSS (31)
      • JavaScript (17)
      • AWS_Cloud (21)
      • 웹스크래핑과 데이터 수집 (14)
      • Flask (42)
      • Django (77)
      • Fastapi (16)
      • 연예 (14)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    classaction
    bts
    travel ban
    college reunions
    urbantrends
    titaniumcase
    basalcellcarcinoma
    smartphonedurability
    btsreunion
    lawsuitculture
    remittance
    gpterror
    뷔
    btscomeback
    youngprofessionals
    homebartrend
    americanlaw
    chatgpterror
    trumpmuskclash
    btsdischarge
    livebroadcast
    americaparty
    btsjungkook
    newpoliticalparty
    hotcoffeecase
    global politics
    life reflection
    self-growth
    RM
    chinanightlife
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.3
Chansman
🖥️ PyCharm WSL Interpreter 설정 오류

개인정보

  • 티스토리 홈
  • 포럼
  • 로그인
상단으로

티스토리툴바

단축키

내 블로그

내 블로그 - 관리자 홈 전환
Q
Q
새 글 쓰기
W
W

블로그 게시글

글 수정 (권한 있는 경우)
E
E
댓글 영역으로 이동
C
C

모든 영역

이 페이지의 URL 복사
S
S
맨 위로 이동
T
T
티스토리 홈 이동
H
H
단축키 안내
Shift + /
⇧ + /

* 단축키는 한글/영문 대소문자로 이용 가능하며, 티스토리 기본 도메인에서만 동작합니다.