🚀 30분 만에 끝내는 윈도우 11 WSL2 개발환경 세팅: 쉽고 빠른 마스터 가이드!

 

 

🚀 30분 만에 끝내는 윈도우 11 WSL2 개발환경 세팅: 쉽고 빠른 마스터 가이드!

 

목차

1. WSL2, 왜 개발자에게 필수일까?
2. 초고속 WSL2 설치 및 초기 설정 (단, 10분!)
   • 2.1. 필수 조건 확인 및 'wsl --install' 명령어 사용
   • 2.2. Linux 배포판 선택 및 초기 사용자 설정
3. WSL2 심화 활용: Windows와의 완벽한 통합
   • 3.1. 파일 시스템 접근: Windows와 Linux 간의 자유로운 이동
   • 3.2. 터미널 환경 개선: Windows Terminal 활용
4. VS Code를 활용한 WSL2 개발 환경 구축
   • 4.1. Remote - WSL 확장 설치
   • 4.2. 프로젝트 폴더 열기 및 개발 시작
5. Docker Desktop with WSL2: 컨테이너 개발 환경의 완성
   • 5.1. Docker Desktop 설치 및 WSL2 통합 설정
   • 5.2. Docker 컨테이너 실행 및 관리

---

1. WSL2, 왜 개발자에게 필수일까?

최신 개발 트렌드는 Linux 기반의 환경을 표준으로 삼고 있습니다. 서버 운영체제부터 컨테이너 기술(Docker, Kubernetes)까지 대부분 Linux 환경에서 가장 안정적이고 효율적으로 작동합니다. 하지만 많은 개발자가 Windows 운영체제의 편리함을 포기하기 어렵죠. 여기에 **WSL2 (Windows Subsystem for Linux 2)**가 해답을 제시합니다.

WSL2는 가상 머신(VM)을 사용하지 않고도 경량화된 가상화 기술을 통해 Windows 내에서 완전한 Linux 커널을 실행할 수 있도록 합니다. 이는 기존 WSL1의 호환성 및 성능 한계를 완전히 극복합니다. 특히, Docker와 같은 I/O 집약적인 작업이나 네트워크 성능이 중요한 개발 환경에서 네이티브 Linux에 준하는 속도를 제공하여, Windows 사용자도 복잡한 듀얼 부팅이나 무거운 VM 없이 최적의 개발 환경을 구축할 수 있게 해줍니다. Windows 11은 WSL2를 기본 통합하여 그 설치와 사용 편의성이 극대화되었습니다.

---

2. 초고속 WSL2 설치 및 초기 설정 (단, 10분!)

Windows 11에서는 과거처럼 복잡한 Windows 기능 활성화나 스토어 설치 과정 없이 단 하나의 명령어로 WSL2 환경을 설정할 수 있습니다. 이것이 바로 가장 빠르고 쉬운 방법입니다.

2.1. 필수 조건 확인 및 'wsl --install' 명령어 사용

먼저, Windows 11이 최신 업데이트 상태인지 확인하세요. 이후, 관리자 권한으로 PowerShell 또는 명령 프롬프트를 실행합니다.

wsl --install

이 명령은 다음 작업을 자동으로 처리합니다:

1. 가상 머신 플랫폼 및 Linux용 Windows 하위 시스템 선택적 기능 활성화.
2. 필요한 WSL 커널 업데이트 다운로드 및 설치.
3. Ubuntu (기본 배포판) 설치.

설치가 완료되면 컴퓨터를 재부팅하라는 메시지가 나타날 수 있습니다. 재부팅 후에는 Ubuntu 터미널이 자동으로 실행되어 초기 설정 단계로 진입합니다.

2.2. Linux 배포판 선택 및 초기 사용자 설정

wsl --install 명령은 기본적으로 Ubuntu를 설치합니다. 만약 다른 배포판(예: Debian, Kali, SUSE)을 설치하고 싶다면, 설치 후 다음 명령을 사용하여 사용 가능한 목록을 확인하고 원하는 배포판을 설치할 수 있습니다.

wsl --list --online
wsl --install -d <배포판 이름> # 예: wsl --install -d Debian

자동으로 실행된 Ubuntu 터미널에서 새로운 UNIX 사용자 계정과 암호를 설정해야 합니다. 이 계정은 향후 sudo 명령을 사용할 때 필요하며, Windows 계정과는 별개입니다.

팁: 설치 직후에는 시스템을 최신 상태로 유지하기 위해 다음 명령을 실행하는 것이 좋습니다.

sudo apt update && sudo apt upgrade

---

3. WSL2 심화 활용: Windows와의 완벽한 통합

WSL2의 진정한 장점은 Windows 운영체제와의 매끄러운 통합에 있습니다. 개발자는 이 통합 기능을 활용하여 Linux와 Windows 환경을 자유롭게 넘나들 수 있습니다.

3.1. 파일 시스템 접근: Windows와 Linux 간의 자유로운 이동

WSL2 환경 내에서 Windows 파일에 접근할 때는 /mnt/<드라이브 문자> 경로를 사용합니다. 예를 들어, Windows의 C: 드라이브는 /mnt/c로 접근할 수 있습니다. 하지만, 성능을 극대화하고 파일 변경 알림 기능을 완벽하게 사용하기 위해서는 프로젝트 파일을 Linux 환경 내에 두는 것이 핵심입니다.

WSL2 환경의 파일은 Windows 파일 탐색기에서 네트워크 드라이브처럼 접근할 수 있습니다. 파일 탐색기 주소창에 \\wsl$을 입력하면 현재 설치된 모든 Linux 배포판 폴더가 나타나며, 이를 통해 Windows 앱으로 Linux 파일에 쉽게 접근하고 편집할 수 있습니다. WSL2 내부 경로($HOME)에 프로젝트를 저장하고, Windows 도구를 통해 접근하는 방식이 최적의 워크플로우를 제공합니다.

3.2. 터미널 환경 개선: Windows Terminal 활용

Windows 11의 Windows Terminal은 WSL 환경을 위한 최고의 터미널 애플리케이션입니다. 여러 탭에서 PowerShell, 명령 프롬프트, 그리고 설치된 모든 WSL 배포판(예: Ubuntu, Debian) 세션을 동시에 실행할 수 있습니다.

Windows Terminal을 실행하면 WSL 세션이 목록에 자동으로 나타나며, GPU 가속 기능을 지원하여 텍스트 렌더링이 빠르고 부드럽습니다. 폰트 설정, 색상 스키마 등을 커스터마이징하여 시각적으로 편안하고 효율적인 개발 환경을 구축할 수 있습니다.

---

4. VS Code를 활용한 WSL2 개발 환경 구축

**Visual Studio Code (VS Code)**는 WSL2 개발 환경의 사실상의 표준 도구입니다. Remote - WSL 확장을 통해 Windows 앱처럼 VS Code를 실행하면서, 모든 코드 편집, 빌드, 디버깅 작업을 WSL2의 Linux 환경에서 직접 수행할 수 있습니다.

4.1. Remote - WSL 확장 설치

1. VS Code를 실행합니다.
2. 좌측 확장(Extensions) 탭을 열고 **"Remote - WSL"**을 검색하여 설치합니다.

이 확장을 설치하면, VS Code가 Windows에서 실행되지만 VS Code Server라는 프로세스가 WSL2 환경 내에 자동으로 설치됩니다. 이 서버가 실제 Linux 환경에서의 모든 작업을 처리하므로, 개발자는 마치 네이티브 Linux에서 개발하는 것과 같은 경험을 얻게 됩니다.

4.2. 프로젝트 폴더 열기 및 개발 시작

프로젝트 폴더를 WSL2 내부에 위치시킨 후 (예: ~/projects/my_app), 다음 두 가지 방법 중 하나로 VS Code를 실행합니다.

방법 1: WSL 터미널에서 실행 (가장 권장)
WSL 터미널에서 프로젝트 폴더로 이동한 후 다음 명령어를 입력합니다.

code .

이 명령어는 Windows에 설치된 VS Code를 열면서, 현재 WSL 폴더를 원격으로 연결하여 줍니다. VS Code 왼쪽 하단에 **"WSL: Ubuntu"**와 같은 표시가 나타나면 성공적으로 연결된 것입니다.

방법 2: VS Code 명령어 팔레트 사용
VS Code를 연 후 Ctrl+Shift+P를 눌러 명령어 팔레트를 열고, **"Remote-WSL: Open Folder in WSL..."**을 검색하여 원하는 WSL2 경로를 선택합니다.

이후부터는 VS Code에서 터미널을 열면 Linux 셸이 실행되며, 모든 개발 언어 런타임, 컴파일러, Node.js, Python, Ruby 등의 환경이 WSL2 내부에 설치된 것을 사용하게 되어 완벽하게 격리되고 효율적인 개발이 가능해집니다.

---

5. Docker Desktop with WSL2: 컨테이너 개발 환경의 완성

현대 개발에서 Docker 컨테이너 기술은 필수입니다. WSL2는 Docker Desktop과 연동하여 가장 빠르고 네이티브에 가까운 컨테이너 개발 환경을 제공합니다.

5.1. Docker Desktop 설치 및 WSL2 통합 설정

1. Docker Desktop for Windows를 다운로드하여 설치합니다.
2. 설치 중 또는 설치 후 Docker Desktop 설정 (Settings)에서 "Use the WSL 2 based engine" 옵션이 활성화되어 있는지 확인합니다.
3. "Resources" $\rightarrow$ "WSL Integration" 탭으로 이동하여, 개발에 사용할 Linux 배포판 (예: Ubuntu)에 대한 통합 옵션을 활성화합니다.

이 설정이 완료되면, Windows의 Docker Desktop이 WSL2 커널을 기반으로 Docker 데몬을 실행하게 됩니다.

5.2. Docker 컨테이너 실행 및 관리

WSL2 터미널(Ubuntu)에서 docker version 명령을 입력하여 Docker가 정상적으로 인식되는지 확인합니다.

docker run -d -p 8080:80 docker/getting-started

위와 같이 WSL2 터미널에서 실행한 Docker 명령은 Windows의 Docker Desktop을 통해 실행되지만, WSL2의 Linux 환경에서 실행되는 것처럼 작동합니다. 이제 개발자는 Windows와 Linux의 경계를 허물고 가장 효율적인 컨테이너 기반 개발 환경을 완벽하게 구축한 것입니다. 이 환경은 빌드 속도, 파일 I/O 성능, 네트워크 성능 등 모든 면에서 최적화되어, 개발 생산성을 극대화합니다.

 

더 자세한 참고자료는 아래를 참고하세요.

 

더 자세한 참고자료 보기