윈도우에 WSL(리눅스용 Windows 하위 시스템) 설치하는 방법과 설치 오류 대처
WSL은 관리자 터미널에서 wsl --install 한 줄로 설치하는 것이 Microsoft 권장 방법입니다. 이 명령이 지원되지 않는 오래된 윈도우는 WSL 기능과 가상 머신 플랫폼을 켜고, 커널 업데이트 후 wsl --set-default-version 2를 실행하는 수동 설치를 합니다.
빠른 해결 요약
- 시작 버튼 우클릭 → 터미널(관리자)
- wsl --install 실행 → 재시작
- 재시작 후 우분투 사용자 이름·암호 만들기
- 오류 코드가 나오면 아래 표에서 해당 문서로
이런 증상일 때 보는 글입니다
- 개발 공부를 위해 윈도우에서 리눅스를 쓰고 싶을 때
- wsl --install이 오류로 끝날 때
해결 방법별 소요 시간·난이도·위험도
| 방법 | 소요 시간 | 난이도 | 관리자 권한 | 데이터·설정 위험 |
|---|---|---|---|---|
| wsl --install | 15분 | 쉬움 | 필요 | 없음 |
| 수동 설치 | 30분 | 보통 | 필요 | 없음 |
소요 시간은 일반적인 PC 기준 예상치이며 장치 상태에 따라 달라질 수 있습니다.
방법 1: wsl --install
시작 버튼 우클릭 → 터미널(관리자) 또는 Windows PowerShell(관리자)를 열고 아래 명령을 실행합니다. 필요한 기능과 기본 배포판(우분투)이 함께 설치되며, 끝나면 재시작을 요구합니다.
실행 효과 WSL과 기본 리눅스 배포판을 설치합니다.
wsl --install재시작 후 우분투 창이 열리면 리눅스용 사용자 이름과 암호를 만듭니다. 이 암호는 Windows 암호와 별개입니다.
방법 2: 수동 설치(오래된 빌드)
실행 효과 1단계: WSL 기능을 켭니다.
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart실행 효과 2단계: WSL 2에 필요한 가상 머신 플랫폼을 켭니다.
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart재시작 후 Microsoft 문서의 WSL 2 리눅스 커널 업데이트 패키지를 설치하고, 기본 버전을 2로 정합니다. Microsoft Store 버전을 쓰려면 wsl --update를 실행합니다.
실행 효과 새로 설치하는 배포판의 기본값을 WSL 2로 정합니다.
wsl --set-default-version 2설치 중 자주 나는 오류
| 오류 | 원인 | 문서 |
|---|---|---|
| 0x80370102 | 가상화(BIOS) 또는 가상 머신 플랫폼 꺼짐 | 가상화(0x80370102) 해결 |
| 0x8007019e | WSL 기능 꺼짐 | 0x8007019e |
| 0x80070003 | 배포판을 C 드라이브 외에 저장 | 0x80070003 |
| 커널 업데이트 필요 | WSL 2 커널 미설치 | 커널 업데이트 |
자주 묻는 질문
WSL 1과 2 중 무엇을 써야 하나요?
대부분 WSL 2가 기본이며 호환성과 속도가 좋습니다. 가상화를 쓸 수 없는 PC는 WSL 1을 사용할 수 있습니다.
다음으로 확인할 해결 가이드
원인을 모르겠다면 증상을 선택해 해당 가이드로 이동하는 IT 오류 자가진단을 이용해 보세요.
공식 참고 문서
외부 링크는 현재 창에서 열립니다. 뒤로 가기로 이 글에 돌아올 수 있습니다.
이 방법으로 문제가 해결됐나요?