WSL 개발환경 구성 가이드
Notes
지속 업데이트 예정입니다.
WSL 개발 환경 구성 가이드: VS Code, PyCharm, 폰트 설정
IDE는 어디에 설치해야 하나?
VS Code와 PyCharm 모두 Windows에 설치한다. WSL 안에 설치하는 것이 아니다.
UI는 Windows에서 렌더링되고, 백엔드(파일 시스템, 터미널, 확장 등)만 WSL에서 동작하는 구조다.
| 도구 | 설치 위치 | 비고 |
|---|---|---|
| VS Code | Windows | WSL 터미널에서 code .으로 바로 실행 가능 |
| PyCharm | Windows | Settings > Project > Python Interpreter > WSL 설정 |
코드는 어디에 둬야 하나?
WSL 파일시스템 내에 클론하고 거기서 열어야 한다. Windows 파일시스템(/mnt/c/...)에서 작업하면 성능이 크게 떨어진다.
WSL 파일시스템 (~/...) |
Windows 파일시스템 (/mnt/c/...) |
|
|---|---|---|
| 파일 I/O 속도 | 빠름 (네이티브) | 매우 느림 (9p 프로토콜 경유) |
| git 작업 | 빠름 | 체감될 정도로 느림 |
| 빌드/컴파일 | 빠름 | 2~5배 느림 |
| 파일 감시 (hot reload) | 정상 동작 | 누락되거나 지연됨 |
# 권장 워크플로우
cd ~
mkdir -p workspace && cd workspace
git clone <repo-url>
code . # VS Code가 Remote-WSL 모드로 열림
폰트는 어디에 설치해야 하나?
Windows에 설치한다. VS Code 통합 터미널, Windows Terminal, PyCharm 터미널 모두 Windows 쪽에서 렌더링되기 때문이다.
단, WSLg나 X11 포워딩으로 WSL 내부에서 직접 GUI 앱을 실행하는 경우에는 WSL에도 폰트 설치가 필요하다.
Monaspace Nerd Font 이해하기
폰트 패밀리: 비활성 기체(Noble Gas) 이름
Monaspace는 GitHub이 만든 코딩용 폰트 슈퍼패밀리로, 5가지 스타일이 있다. 약자는 국가코드가 아니라 화학 원소 기호다.
| 약자 | 이름 | 원소 | 스타일 |
|---|---|---|---|
| Ne | Neon | 네온 (10번) | 네오 그로테스크 산세리프 |
| Ar | Argon | 아르곤 (18번) | 휴머니스트 산세리프 |
| Xe | Xenon | 제논 (54번) | 슬랩 세리프 |
| Kr | Krypton | 크립톤 (36번) | 메카니컬 산세리프 |
| Rn | Radon | 라돈 (86번) | 핸드라이팅 스타일 |
5개 모두 메트릭(글자 폭/높이)이 동일해서 서로 섞어 쓸 수 있다.
Nerd Font 변형: NF vs NFM vs NFP
Nerd Font 패치 시 아이콘 글리프 처리 방식에 따라 3가지 변형이 생긴다.
| 접미사 | 의미 | 아이콘 크기 | 용도 |
|---|---|---|---|
| NF | Nerd Font (기본) | 약 1.5셀 (큼) | 아이콘을 크게 보고 싶을 때 |
| NFM | Nerd Font Mono | 1셀에 맞춤 (축소) | 터미널, 코드 에디터 |
| NFP | Nerd Font Propo | 비고정폭 | GUI 요소, 프레젠테이션 |
터미널 및 코드 에디터에서는 NFM(Nerd Font Mono)을 사용해야 아이콘이 셀 그리드에 맞아 정렬이 깨지지 않는다.
예: MonaspiceKr NFM (Krypton 스타일의 Nerd Font Mono 버전)