📌 WSL + VS Code 연동 및 'code' 명령어 설정 방법 정리

📌 WSL + VS Code 연동 및 'code' 명령어 설정 방법 정리

이 문서는 Windows + WSL 환경에서 VS Code를 활용하기 위해 필수적인 설정 과정들을 정리한 가이드입니다.

---

✅ 1. VS Code 설치 후 필수 확장 설치

• Windows에서 Visual Studio Code 설치
• WSL 확장 설치
  • VS Code 좌측 확장 탭에서 wsl 검색 후 설치 (Microsoft 공식)
  • 설치 후 VS Code를 재시작

---

✅ 2. WSL 내에서 'code' 명령어 사용 설정

1️⃣ WSL에서 code 명령어가 안 될 때:

❯ code .
zsh: command not found: code

2️⃣ 실제로는 Windows 경로에 있음:

❯ ls /mnt/c/Users/LG\ 울트라PC/AppData/Local/Programs/Microsoft\ VS\ Code/bin
code  code-tunnel.exe  code.cmd

3️⃣ 이 경로를 $PATH에 추가해야 함:

zsh 설정 파일 수정:

nano ~/.zshrc

다음 줄을 맨 아래에 추가:

# VS Code 실행 명령어 추가
export PATH="$PATH:/mnt/c/Users/LG 울트라PC/AppData/Local/Programs/Microsoft VS Code/bin"

저장 후 적용:

source ~/.zshrc

4️⃣ 확인:

which code
# 출력 예시:
/mnt/c/Users/LG 울트라PC/AppData/Local/Programs/Microsoft VS Code/bin/code

---

✅ 3. 💡 Windows 환경변수도 함께 설정 (중요!)

1️⃣ Windows에서 code 명령이 되도록 하기 위해:

• 시작 > 시스템 환경 변수 편집 > 환경 변수 > 시스템 변수 > Path 편집 클릭
• 아래 경로 추가:

C:\Users\LG 울트라PC\AppData\Local\Programs\Microsoft VS Code\bin

• 적용 후, 새로운 CMD 또는 PowerShell 창을 열고 code 입력 시 VS Code 실행 확인

---

✅ 4. 자주 쓰는 명령어 모음 (WSL 내 터미널에서)

명령어 설명

code .	현재 디렉토리를 VS Code에서 열기
which code	code 명령어의 경로 확인
echo $PATH	환경변수 PATH 확인
nano ~/.zshrc	zsh 설정파일 수정
source ~/.zshrc	zsh 설정 반영
ls /mnt/c/...	Windows 경로 접근 및 파일 확인

---

🎉 이제 VS Code에서 WSL 통합 개발환경을 자유롭게 사용할 수 있습니다!

• 추가적으로 Git, Python, Poetry, Docker 등을 연동하면 실무용 Dev 환경 완성도 UP!
• 문제 발생 시 code 명령어 위치부터 점검해보세요 🔍