WSL을 사용하여 Windows에 Linux 개발환경 구축

Linux용 Windows 하위 시스템 (Windows Subsystem for Linux, WSL)을 사용하여 Windows에 Linux 개발환경을 구축해보겠습니다.

WSL 설치하기

WSL2 설치하기

WSL 설치하는 방법은 OS 따라서 상이합니다. Windows 10 10901 이상 및 Windows 11은 자동 설치로 설치할 수 있고 그 외 버전은 수동 설치로 설치합니다.

1. 자동 설치 ( Windows 10 19041 이상 or Windows 11 )

PowerShell을 관리자 권한으로 실행하고 다음과 같이 입력합니다. 설치 완료 후 PC를 재부팅 합니다.

wsl --install

설치 중: 가상 머신 플랫폼
가상 머신 플랫폼이(가) 설치되었습니다.
설치 중: Linux용 Windows 하위 시스템
Linux용 Windows 하위 시스템이(가) 설치되었습니다.
설치 중: Ubuntu
Ubuntu이(가) 설치되었습니다.
요청한 작업이 잘 실행되었습니다. 시스템을 다시 시작하면 변경 사항이 적용됩니다.

2. 수동 설치 ( 자동 설치 환경이 아닌 경우 )

PowerShell을 관리자 권한으로 실행하고 다음과 같이 입력합니다. 설치 완료 후 PC를 재부팅 합니다.

# 1. Linux용 Windows 하위 시스템 옵션 기능을 사용하도록 설
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
 
# 2. Virtual Machine 플랫폼 옵션 기능을 사용하도록 설정
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
 
# 3. 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정
wsl --set-default-version 2

Linux 설치 (Ubuntu)

Microsoft Store 앱을 실행 하고 ubuntu 검색 합니다. 아래 그림과 같이 다양한 ubuntu 버전이 나오는데 WSL을 지원하는 버전 중에서 원하는 버전을 설치하면 됩니다. 저는 Ubuntu 22.04.3 LTS 버전을 설치했습니다.

다운로드가 완료되면 앱을 실행하여 WSL을 시작합니다. 만약 다음과 같은 오류가 발생하면 PC를 재부팅하고 다시 실행해보세요.

Installing, this may take a few minutes…
WslRegisterDistribution failed with error: 0x8004032d
Error: 0x8004032d (null)
Press any key to continue…

VSCode 연결하기

VSCode Extension에서 WSL 검색 후 설치 합니다. WSL Extension 설치 완료 후 Linux에서 작업 폴더로 이동하여 code . 명령을 입력하면 아래와 같이 VSCode가 실행됩니다.

# 프로젝트 폴더로 이동
$ cd ~/workspace/myproject
# VSCode 실행
$ code .

Windows Subsystem

WSL은 VMWare나 Hyper-V와 같이 완전히 독립된 환경이 아니라 윈도우 서브시스템으로 윈도우 OS와 많은 부분을 공유하고 있습니다. 독립적인 환경이 아니라 불편한 점도 있지만 위 항목과 같이 VSCode를 Windows에서 사용할 수 있는 점과 아래 그림과 같이 탐색기에 자동으로 Linux가 마운트 되어 윈도우 탐색기를 통해 직접 파일을 제어할 수 있는 장점이 있습니다.

참고 자료