🐧 WSL + Python 3.13 + Poetry + PyCharm 프로젝트 설정 가이드 (Windows)

🐧 WSL + Python 3.13 + Poetry + PyCharm 프로젝트 설정 가이드 (Windows)

윈도우 환경에서 WSL(Ubuntu)을 기반으로 Python 3.13 개발 환경을 구성하고, 이를 Poetry 및 PyCharm과 연동하는 전체 과정을 정리한 가이드입니다.

---

✅ 준비 사항

• WSL(Ubuntu 22.04 이상) 설치 완료 (이 단계는 생방)
• PyCharm Professional 설치됨

---

1️⃣ Python 3.13 설치

기본 Python 3.10을 사용하는 Ubuntu에 Python 3.13을 수동 설치합니다.

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev

버전 확인:

/usr/bin/python3.13 --version

---

2️⃣ Poetry 설치

기존 Poetry 제거 후 새로 설치합니다:

curl -sSL https://install.python-poetry.org | python3 - --version 1.8.5

Poetry 경로를 PATH에 등록:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

버전 확인:

poetry --version

---

3️⃣ 프로젝트 폴더 생성 및 초기화

cd ~
mkdir -p PycharmProjects
cd PycharmProjects
poetry new when2meet_vod
cd when2meet_vod

Python 3.13로 가상환경 설정:

poetry env use /usr/bin/python3.13
poetry install

가상환경 경로 확인:

poetry env info --path

데이터 예시:

/home/rainsos/.cache/pypoetry/virtualenvs/when2meet-vod-xxx-py3.13

---

4️⃣ PyCharm에서 인터프리터 설정

WSL 터미널에서 PyCharm 실행

charm .

PyCharm에서 설정:

1. File → Settings → Python Interpreter
2. → 투리(⚙) 클릭 → Add...
3. 좌측 WSL 선택 → 하나의 경로 입력:
4. /home/rainsos/.cache/pypoetry/virtualenvs/when2meet-vod-xxx-py3.13/bin/python

---

5️⃣ Poetry 경로 수동 등록 (Windows 경로)

PyCharm 하단에 뜨는 알림창에서 poetry 실행 경로를 찾을 수 없습니다 라고 나오면:

→ 수동 설정 클릭 후, 다음과 같이 경로 입력:

\\wsl.localhost\Ubuntu-22.04\home\rainsos\.local\bin\poetry

---

6️⃣ 가상환경 활성화 및 확인

PyCharm 터미널에서 확인:

poetry shell
python --version  # Python 3.13.x

또는:

poetry run python --version

---

🎉 마무리 체크리스트

• Python 3.13 수동 설치 완료
• Poetry 1.8.5 설치 및 PATH 등록
• 프로젝트 생성 및 Python 3.13 가상환경 연결
• PyCharm에 가상환경 직접 등록 완료
• poetry shell 또는 poetry run 으로 Python 3.13 확인

이제 FastAPI 또는 기타 Python 프로젝트를 시작할 수 있습니다!