'WSL 2에는 커널 구성 요소 업데이트가 필요합니다' 해결 방법
이 메시지는 WSL 2용 리눅스 커널이 설치되지 않았다는 뜻입니다. 관리자 터미널에서 wsl --update를 실행하면 최신 커널이 설치됩니다. 한국어 윈도우에서는 같은 원인이 오류 0x1bc나 'WSL 2'만 표시되는 잘린 메시지로 보이기도 합니다.
빠른 해결 요약
- 관리자 터미널에서 wsl --update
- wsl --shutdown 후 다시 실행
- 안 되면 Microsoft 문서의 커널 업데이트 패키지(MSI) 설치
- wsl --set-default-version 2 다시 실행
이런 증상일 때 보는 글입니다
- WSL 2로 바꾸려는데 커널 업데이트 안내가 뜰 때
- 0x1bc 오류가 날 때
해결 방법별 소요 시간·난이도·위험도
| 방법 | 소요 시간 | 난이도 | 관리자 권한 | 데이터·설정 위험 |
|---|---|---|---|---|
| wsl --update | 5분 | 쉬움 | 필요 | 없음 |
| 커널 패키지 설치 | 5분 | 쉬움 | 필요 | 없음 |
소요 시간은 일반적인 PC 기준 예상치이며 장치 상태에 따라 달라질 수 있습니다.
1단계: wsl --update
실행 효과 WSL과 리눅스 커널을 최신으로 업데이트합니다(관리자).
PowerShell
wsl --update실행 효과 실행 중인 WSL을 모두 종료합니다. 업데이트 후 다시 시작할 때 사용합니다.
PowerShell
wsl --shutdown2단계: 커널 업데이트 패키지
명령으로 업데이트가 안 되는 오래된 빌드는 Microsoft 수동 설치 문서 4단계의 'WSL2 Linux 커널 업데이트 패키지'를 받아 설치합니다. 패키지가 깨졌다면 설정 > 앱에서 'Windows Subsystem for Linux Update'를 제거하고 다시 설치합니다.
한국어 윈도우에서 보이는 모습
Microsoft 문서는 표시 언어가 영어가 아닌 경우 이 오류가 '0x1bc'나 'WSL 2' 한 단어로만 보일 수 있다고 설명합니다. 원인은 같으므로 위 방법으로 커널을 설치하면 됩니다.
3단계: 기본 버전 설정
실행 효과 이후 설치하는 배포판을 WSL 2로 만듭니다.
PowerShell
wsl --set-default-version 2자주 묻는 질문
이미 설치한 우분투도 WSL 2로 바꿀 수 있나요?
wsl --set-version Ubuntu 2로 바꿀 수 있습니다. 배포판 이름은 wsl -l -v로 확인하세요.
다음으로 확인할 해결 가이드
시스템·블루스크린WSL 설치 방법 — wsl --install과 수동 설치WSL은 관리자 터미널에서 wsl --install 한 줄로 설치하는 것이 Microsoft 권장 방법입니다. 이 명령이 지원되지 않는 오래된 윈도우는 WSL 기…시스템·블루스크린WSL 0x80370102 오류 해결 — 가상화 켜기0x80370102는 WSL 2를 돌릴 가상화 기능이 꺼져 있다는 뜻입니다. BIOS에서 가상화(Intel VT-x·AMD SVM)를 켜고, Windows 기능에…시스템·블루스크린WSL 0x8000FFFF 오류 해결 방법0x8000FFFF는 WSL 구성 요소가 예기치 않게 실패한 경우입니다. Microsoft 문서는 관리자 권한으로 wsl --update → wsl --shutd…
원인을 모르겠다면 증상을 선택해 해당 가이드로 이동하는 IT 오류 자가진단을 이용해 보세요.
공식 참고 문서
외부 링크는 현재 창에서 열립니다. 뒤로 가기로 이 글에 돌아올 수 있습니다.
이 방법으로 문제가 해결됐나요?