🛠 WSL에서 PyCharm 디버깅 경로 매핑 완전 정리

🛠 WSL에서 PyCharm 디버깅 경로 매핑 완전 정리

 

✅ 문제 상황 요약
PyCharm에서 WSL 환경으로 디버깅할 때 다음과 같은 오류가 발생할 수 있습니다:

원격 파일에 경로 매핑을 적용할 수 없습니다.
/home/rainsos/.../base62.py 를 찾을 수 없습니다.

이는 WSL 내부 경로와 PyCharm이 인식하는 UNC 경로 간의 불일치 때문입니다.

---

✅ 해결 순서 요약

1️⃣ WSL 터미널에서 현재 경로 확인

pwd

예시 결과:

/home/rainsos/PycharmProjects/when2meet_vod

➡️ 이 경로가 실제로 소스 파일이 위치한 디렉토리입니다.

---

2️⃣ PyCharm에서 배포 설정(Deployment) 열기

• 메뉴: File > Settings > Build, Execution, Deployment > Deployment
• + 클릭 → 로컬 또는 마운트된 폴더(Local or mounted folder) 선택
• 이름은 자유롭게 설정 (예: WSL Mapping)

---

3️⃣ 연결(Connections) 탭 설정

항목 값

타입	로컬 또는 마운트된 폴더
폴더(F)	\\wsl.localhost\Ubuntu-22.04\home\rainsos\PycharmProjects\when2meet_vod
웹 서버 URL	비워도 무방

⚠️ "UNC 경로 미지원" 경고는 무시해도 디버깅에는 영향 없습니다.

---

4️⃣ 매핑(Mappings) 탭 설정

항목 값

로컬 경로	\\wsl.localhost\Ubuntu-22.04\home\rainsos\PycharmProjects\when2meet_vod
배포 경로(E)	/home/rainsos/PycharmProjects/when2meet_vod ← pwd 명령어 결과와 정확히 일치하게! (대소문자 포함)

✅ 이 설정을 통해 디버깅 시 WSL 내부 경로와 PyCharm 소스가 정확히 매핑되어 base62.py 등이 정상적으로 열립니다.

---

5️⃣ 디버깅 실행 & 확인

• 브레이크포인트 설정
• Run > Debug 실행
• 오류 없이 소스가 열리면 성공 🎉

---

🔁 참고 팁

항목 설명

pwd	항상 정확한 WSL 내 경로를 확인하는 데 사용
대소문자	리눅스는 대소문자를 구분하므로 반드시 주의
charm .	WSL 터미널에서 해당 경로를 PyCharm으로 직접 열 수 있음
UNC 경고	무시해도 디버깅에는 영향 없음

---

✅ 결론
WSL에서 디버깅 오류가 발생하면:

1. WSL에서 pwd로 실제 경로를 확인하고,
2. PyCharm의 배포 설정에서 매핑 경로를 정확히 그 경로로 맞추면 문제는 해결됩니다!

꼭 기억하세요: **"경로 매핑 정확성 = 디버깅 성공"**입니다 😊