공식 문서 : https://learn.microsoft.com/ko-kr/windows/wsl/install

WSL2(Windows Subsystem for Linux 2) 설치는 Windows 10(버전 2004 빌드 19041 이상) 또는 Windows 11에서 PowerShell 명령어로 간단하게 진행할 수 있습니다. 다음 가이드에 따라 한 번에 설치하고, 원하는 리눅스 배포판까지 손쉽게 활용할 수 있습니다.

설치 전 준비

• 윈도우 버전 확인: Windows 10 버전 2004(빌드 19041) 이상 또는 Windows 11이 필요합니다.

• 관리자 권한 PowerShell 을 실행해주세요.

  

자동 설치 방법

1. 관리자 권한 터미널(PowerShell 또는 Windows Terminal)에서 아래 명령어 입력

   wsl --install
   

   

   • 필요한 WSL 구성요소와 기본 리눅스 배포판까지 자동 설치됩니다.

2. 설치 완료 후 컴퓨터를 재부팅합니다.

3. 기본 WSL 버전을 2로 설정

   wsl --set-default-version 2
   

   • 이후 설치되는 모든 배포판이 WSL2로 실행됩니다.

리눅스 배포판 설치

• Microsoft Store에서 Ubuntu 검색 후 설치합니다.

  

  

• 또는 아래 명령어로 설치

  wsl --install -d Ubuntu
  

• 설치 후 사용자 계정(Username/Password) 설정

설치 확인 및 버전 관리

• 설치된 배포판과 WSL 버전 확인

  wsl -l -v
  

• WSL 전체 업데이트

  wsl --update
  

자주 발생하는 문제 해결

• 설치 진행이 안되는 경우, 제어판 → 프로그램 → Windows 기능 켜기/끄기 → Linux용 Window 하위 시스템 + Hyper-V 를 체크합니다.

  

• powershell이 관리자 권한으로 실행되었는지 확인하세요.