PyCharm - WSL과 연동해 Django App을 윈도우에서 리눅스 대상으로 개발
PyCharm을 WSL과 연동하는 방법은 공식 문서에 잘 나와 있습니다.
Configure an interpreter using WSL
; https://www.jetbrains.com/help/pycharm/using-wsl-as-a-remote-interpreter.html
간략하게 정리해 보면, WSL 측에 rsync를 설치하고,
$ sudo apt install rsync
// Django App이라면 WSL 측에도 설치
$ pip3 install Django
WSL의 python 경로를 확인한 후,
$ which python3
/usr/bin/python3
윈도우의 PyCharm 실행 화면의 "Settings"에서 다음과 같이 WSL/python 환경을 추가합니다.
그럼, "Python Interpreter"에 새롭게 (위의 경우 Ubuntu20.04) 항목이 추가되고, 현재 선택된 "Django Server" 유형으로 생성한 "Run/Debug Configuration"에도 새로운 Interpreter 항목이 선택됩니다.
이제 디버깅을 시작하면, 윈도우의 파이썬 작업 디렉터리를 /mnt/로 매핑시켜 wsl 인스턴스에서 python 프로세스를 구동하는 식으로 동작합니다.
// Django App이 d:\pycharm\work\myapp 디렉터리에 개발이 된 경우로 가정
C:\WINDOWS\system32\wsl.exe --distribution Ubuntu20.04 --exec /bin/sh
-c "
export PYCHARM_DISPLAY_PORT=63342 &&
export PYDEVD_LOAD_VALUES_ASYNC=True &&
export PYTHONPATH='/mnt/...[생략]...:/mnt/d/pycharm/work/myapp' &&
export DJANGO_SETTINGS_MODULE=myapp.settings &&
export PYTHONUNBUFFERED=1 &&
export PYTHONIOENCODING=UTF-8 &&
export LIBRARY_ROOTS='/...[생략]...typeshed/stubs/python-dateutil' &&
export IDE_PROJECT_ROOTS=/mnt/d/pycharm/work/myapp &&
export PYCHARM_HOSTED=1 &&
export IPYTHONENABLE=True &&
export PYTHONDONTWRITEBYTECODE=1 &&
cd /mnt/d/pycharm/work/myapp &&
/usr/bin/python3 '/mnt/c/Program Files/JetBrains/PyCharm 2021.2/plugins/python/helpers/pydev/pydevd.py' --multiproc --qt-support=auto --client 172.22.144.1 --port 20866 --file /mnt/d/pycharm/work/myapp/manage.py runserver 8000
"
즉, 윈도우 환경이면서 리눅스에서 개발하는 것처럼 환경 구성이 된 것입니다. 실제로 코드에 다음과 같은 식으로 실행해 보면 실행 환경이 리눅스임을 알 수 있습니다.
print(os.getcwd())
/* 출력 결과
/mnt/d/pycharm/work/myapp
*/
참고로, WSL이 아니더라도 원격 접속이 가능한 리눅스만 있다면 마찬가지로 PyCharm에서 SSH 설정을 이용해 원격 개발이 가능하므로,
PyCharm 에서 원격 인터프리터 사용하기
; https://dandyrilla.github.io/2018-11-26/pycharm-remote/
윈도우 운영체제에서 Python 개발을 하는 것이 크게 난관이 있지는 않습니다.
Django App의 디버깅을 시작했는데 다음과 같은 오류가 발생한다면?
C:\WINDOWS\system32\wsl.exe --distribution Ubuntu20.04 --exec /bin/sh -c "...[생략]... /manage.py runserver 8000"
Traceback (most recent call last):
File "/mnt/d/pycharm/work/myapp/manage.py", line 11, in main
from django.core.management import execute_from_command_line
ModuleNotFoundError: No module named 'django'
지난번에 설명한 글에서처럼 "Django" 구성 요소를 설치해 주면 됩니다.
또는 다음과 같은 식으로 "invalid syntax"가 발생한다면?
File "/mnt/d/pycharm/work/myapp/manage.py", line 17
) from exc
^
SyntaxError: invalid syntax
Process finished with exit code 1
아마 대부분 python3이 아닌 python 2.x로 WSL 측의 프로세스가 실행됐기 때문입니다. PyCharm의 디버그 콘솔 창에 출력된 명령행을 잘 살펴보면,
C:\WINDOWS\system32\wsl.exe
--distribution Ubuntu20.04
--exec /bin/sh -c "export PYCHARM_DISPLAY_PORT=63342 &&
export PYTHONPATH='/mnt/d/pycharm/work/myapp:...[생략]...' &&
export DJANGO_SETTINGS_MODULE=myapp.settings &&
export PYTHONUNBUFFERED=1 &&
export PYTHONIOENCODING=UTF-8 &&
export PYCHARM_HOSTED=1 &&
cd /mnt/d/pycharm/work/myapp &&
/usr/bin/python /mnt/d/pycharm/work/myapp/manage.py runserver 9000"
실행될 python 경로가 출력되는데, WSL 인스턴스에서 확인해 보면 2.x.x 버전이 나올 것입니다. 명시적으로 python3으로 지정하든가 "python-is-python3" 패키지 등을 설치해 우회하시면 됩니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]