✅ WSL에서 pyenv 가상환경을 PyCharm에 연결하는 방법

✅ WSL에서 pyenv 가상환경을 PyCharm에 연결하는 방법

WSL 환경에서 Python 가상환경을 pyenv로 만들었다면, PyCharm에서도 해당 환경을 인터프리터로 연결해줘야 합니다. 이 글에서는 WSL + pyenv 조합으로 만든 가상환경을 PyCharm에 정확하게 등록하는 방법을 단계별로 안내합니다.

---

1️⃣ WSL에서 pyenv 가상환경 경로 확인하기

WSL(예: Ubuntu) 터미널에서 다음 명령어를 입력하세요:

pyenv versions

만든 가상환경 이름이 oz_blog라고 가정하면, 다음으로 pyenv 설치 루트를 확인합니다:

pyenv root

예시 출력:

/home/yourname/.pyenv

가상환경 경로는 아래와 같습니다:

/home/yourname/.pyenv/versions/oz_blog/bin/python

여기서 yourname은 WSL 사용자 계정 이름입니다. whoami 명령어로 확인 가능!

---

2️⃣ PyCharm에서 Interpreter 추가하기

1. PyCharm 열기 → File > Settings > Project: [your_project] > Python Interpreter
2. 우측 상단의 톱니바퀴(⚙️) 클릭 → Add...
3. 왼쪽 메뉴에서 WSL 선택
4. 아래와 같이 Python 경로 입력:

/home/yourname/.pyenv/versions/oz_blog/bin/python

1. OK 누르면 PyCharm이 가상환경을 연결합니다.

---

3️⃣ 정상 연결 확인하기

• PyCharm 우측 하단에 Python 버전과 oz_blog 환경명이 보여야 합니다.
• Terminal에서도 자동으로 해당 가상환경이 활성화되어야 합니다.

---

⚠️ 연결이 안 될 경우 점검사항

• pyenv로 가상환경을 먼저 생성했는지 확인:

pyenv install 3.12.2
pyenv virtualenv 3.12.2 oz_blog
pyenv local oz_blog

• .pyenv 초기화 설정이 되어 있는지 확인 (~/.zshrc 또는 ~/.bashrc):

eval "$(pyenv init --path)"
eval "$(pyenv virtualenv-init -)"

---

✅ 요약

항목 내용

가상환경 이름	oz_blog
가상환경 경로	/home/사용자명/.pyenv/versions/oz_blog/bin/python
PyCharm 연결 방식	Add Interpreter > WSL > 경로 수동 입력
pyenv 명령어	pyenv root, pyenv versions, pyenv virtualenv, pyenv local

---