📌 Windows 11에서 WSL2, Docker, Python, PyCharm 설치 및 연동 가이드

개발 환경은 안정성과 효율성이 중요합니다. **Windows Subsystem for Linux 2 (WSL2)**는 Windows와 Linux의 장점을 동시에 활용할 수 있게 해 주며, Docker, Python, IDE(Pycharm) 등 다양한 도구를 통합하는 데 핵심적인 역할을 합니다.

---

🚀 1. WSL2 설치

🔹 1.1 WSL2 소개와 준비 사항

WSL2는 Microsoft가 배포하는 리눅스 커널로, 가상 머신 없이도 Linux 배포판을 실행할 수 있습니다.

• Windows 11 최신 버전 확인 및 업데이트
• BIOS/UEFI에서 가상화 기술(Intel VT‑x/AMD‑V) 활성화

🔹 1.2 설치 방법

관리자 권한의 PowerShell에서 다음 명령어 실행:

wsl --install

다른 배포판 선택 설치 시:

wsl --install -d <배포판명>

배포판 확인 및 업그레이드:

wsl -l -v
wsl --set-version <배포판명> 2

배포판 업데이트:

sudo apt update && sudo apt upgrade

---

🐳 2. Docker Desktop 설치 및 WSL2 연동

Docker Desktop은 WSL2로 성능과 자원 관리가 효율적입니다.

🔹 2.1 Docker Desktop 설치

• Docker 공식 사이트에서 다운로드 후 설치
• Docker Desktop 실행 → Settings에서 Use WSL 2 based engine 활성화
• Settings → Resources → WSL Integration에서 사용할 배포판 선택

🔹 2.2 Docker 사용 테스트

docker run hello-world

---

🐍 3. WSL 내 Python 환경 구축

Ubuntu에서 Python 설치 및 가상 환경 설정:

🔹 3.1 Python 확인 및 업데이트

python3 --version
sudo apt update && sudo apt upgrade python3

🔹 3.2 pip와 venv 설치

sudo apt install python3-pip python3-venv

🔹 3.3 가상 환경 생성 및 활성화

python3 -m venv .venv
source .venv/bin/activate

---

🔧 4. PyCharm 설치 및 WSL2 연동

PyCharm 다운로드 후 설치.

🔹 4.1 WSL 인터프리터 설정

• Ctrl + Alt + S로 설정창 열기
• Python Interpreter → Add Interpreter → On WSL 선택
• 인터프리터 종류(venv/system) 선택 및 완료

🔹 4.2 WSL 터미널 설정

• Settings → Tools → Terminal → Shell path:

wsl.exe

---

🐋 5. Docker와 Python 환경 통합 활용

개발용 DB 컨테이너 예시:

docker run --name some-postgres -e POSTGRES_PASSWORD=pass -p 5432:5432 -d postgres:16

Docker Compose 사용 예시:

docker compose up

---

🎯 마무리

이 가이드는 전통적이고 효율적인 개발 관행을 중요시하면서도 최신 기술을 통해 생산성을 높이는 방법을 제시했습니다. WSL2, Docker, Python, PyCharm을 통해 안정적이고 미래 지향적인 개발 환경을 구축해 보시길 바랍니다.