윈도우에서 리눅스 쓰기: WSL2 설치 & VS Code 연동 완벽 가이드

1. 왜 이걸 해야 하나요?

• 현업 표준: 네이버, 카카오, 구글 등 모든 서버는 리눅스(Linux) 기반입니다.
• 호환성: 파이썬 라이브러리 중 일부는 윈도우에서 에러가 나지만, 리눅스에서는 한 방에 설치됩니다.
• WSL(Windows Subsystem for Linux): 윈도우 안에 '가상 리눅스'를 심어서, 맥북처럼 터미널을 쓸 수 있게 해주는 MS의 축복 같은 기능입니다.

---

STEP 1. 우분투(Ubuntu) 설치하기 (가장 쉬운 방법)

예전처럼 복잡하게 설정 들어갈 필요 없습니다. 터미널 명령어 한 줄이면 끝납니다.

1. PowerShell을 관리자 권한으로 엽니다.
   • 윈도우 시작 버튼 우클릭 -> 터미널(관리자) 또는 PowerShell(관리자) 선택.
2. 아래 명령어를 입력하고 엔터!
3. Bash

    

   wsl --install
   

4. 컴퓨터 재부팅 (필수!)
   • 재부팅 후 자동으로 검은 창(우분투 설치 창)이 뜹니다. 조금 기다리세요.
5. 계정 생성
   • Enter new UNIX username: 원하는 영어 아이디 입력 (예: dalma)
   • New password: 비밀번호 입력 (타이핑해도 화면에 안 보입니다. 당황하지 말고 입력 후 엔터!)
   • Retype new password: 비밀번호 확인.

👉 설치 완료! 이제 달마님의 윈도우 안에 '리눅스 세상'이 생겼습니다.

---

STEP 2. VS Code와 연동하기

우분투의 검은 창(터미널)에서만 코딩하면 눈 빠집니다. 우리가 쓰는 VS Code를 우분투에 연결해야 합니다.

1. VS Code 실행
2. 확장 프로그램(Extensions) 설치
   • 왼쪽 블록 아이콘 클릭 -> 검색창에 WSL 입력.
   • Microsoft가 만든 'WSL' 설치 (파란색 펭귄 아이콘).
3. 연결하기
   • 왼쪽 맨 아래 초록색 아이콘 >< 모양 클릭.
   • 목록에서 Connect to WSL (또는 New Window using Distro...) 클릭.
4. 확인
   • 새 VS Code 창이 열리고, 왼쪽 아래에 **WSL: Ubuntu**라고 뜨면 성공!

---

STEP 3. 터미널을 'Command Prompt (cmd)'로 고정하기

리눅스를 설치했어도, 달마님은 윈도우 환경에서 cmd를 쓰는 게 편하고 익숙하시죠? VS Code가 자꾸 PowerShell이나 Bash를 띄우지 못하게 cmd를 기본값으로 박제하는 방법입니다.

1. 명령 팔레트 열기: F1 (또는 Ctrl + Shift + P)
2. 검색: Terminal: Select Default Profile 입력 후 엔터. (한글: 기본 프로필 선택)
3. 선택: 목록에서 Command Prompt (명령 프롬프트) 클릭!

👉 결과 확인: 이제 터미널을 껐다가(🗑️) 다시 켜보세요(Ctrl+J). C:\Users\달마> 형태의 친숙한 cmd 창이 뜨면 성공입니다.

---

💡 달마의 시행착오 Note (트러블 슈팅)

• Q. wsl --install 했는데 아무 일도 안 일어나요.
  • A. 윈도우 업데이트가 최신인지 확인해야 함. 그래도 안 되면 '제어판 > Windows 기능 켜기/끄기'에서 'Linux용 Windows 하위 시스템' 체크해야 함.
• Q. 우분투 비밀번호 까먹었어요.
  • A. 윈도우 cmd(관리자) 열고 wsl -u root 입력하면 비밀번호 없이 로그인 가능. 거기서 passwd 계정명 쳐서 바꾸면 됨.
• Q. 윈도우 파일은 어디에 있나요?
  • A. 우분투 안에서 /mnt/c/Users/내이름 경로로 가면 윈도우 파일 접근 가능.
  •  

👨‍💻 추가 조언

리눅스(WSL)를 설치했다고 해서 무조건 거기서만 해야 하는 건 아닙니다.

• 평소: 그냥 윈도우(CMD)에서 황제 가상환경(.env) 쓰면서 편하게 개발.
• 특수 상황: "이 라이브러리는 리눅스에서만 돼요" 하는 순간이 오면 그때 WSL을 켜시면 됩니다.

이 포스팅 내용대로 설치해두시면, 나중에 **"도커(Docker)"**나 "클라우드 배포(AWS)" 배울 때 아주 수월해지실 겁니다! 바로 저장해두세요! 👍