WSL은 파워셸을 관리자 권한으로 열고 wsl --install 한 줄만 입력하면 우분투가 자동으로 설치됩니다. 재부팅 한 번만 해주면 바로 리눅스 터미널을 쓸 수 있습니다.
WSL(Windows Subsystem for Linux)은 가상머신이나 듀얼부팅 없이 윈도우 안에서 리눅스를 그대로 돌릴 수 있게 해주는 마이크로소프트 공식 기능입니다. 예전에는 버추얼박스로 우분투를 따로 띄워야 했는데, WSL2로 넘어오면서 속도도 훨씬 빨라지고 파일 공유도 편해져서 요즘은 개발 환경으로 WSL만 쓰는 경우가 많습니다. 아래에서 설치부터 자주 나는 에러까지 순서대로 정리해드립니다.
WSL1과 WSL2 뭐가 다를까
| 구분 | WSL1 | WSL2 |
| 방식 | 윈도우 커널 위 호환 계층 | 실제 리눅스 커널 탑재 (경량 VM) |
| 파일 I/O 속도 | WSL 내부에서 느림 | 훨씬 빠름 |
| 시스템 콜 호환성 | 일부 미지원 | 거의 완전 호환 |
| 네트워크 | 윈도우와 IP 공유 | 별도 가상 네트워크 사용 |
| 추천 대상 | 구형 하드웨어, 특수 호환 상황 | 대부분의 개발 환경 (기본 권장) |
특별한 이유가 없다면 WSL2를 기본값으로 사용하시면 됩니다. 최신 윈도우에서는 wsl --install 명령만으로 자동으로 WSL2 + 우분투가 설치됩니다.
설치 전 확인할 사항
- 윈도우 10 버전 2004 이상, 또는 윈도우 11
- BIOS/UEFI에서 가상화(Virtualization) 기능이 켜져 있어야 함
- 관리자 권한으로 파워셸 또는 명령 프롬프트 실행
WSL 설치 방법
파워셸을 관리자 권한으로 열고 아래 명령어를 입력합니다.
wsl --install이 한 줄로 WSL2 기능 활성화, 가상 머신 플랫폼 활성화, 기본 배포판(우분투) 설치까지 한 번에 진행됩니다. 다른 배포판을 원한다면 아래처럼 배포판 이름을 지정할 수 있습니다.
wsl --install -d Debian설치가 끝나면 재부팅을 한 번 해준 뒤, 시작 메뉴에서 우분투를 실행해 사용자 이름과 비밀번호를 설정하면 바로 사용할 수 있습니다.
자주 발생하는 에러와 해결법
가상화 관련 오류(0x80370102)가 뜬다면 BIOS에서 가상화 옵션이 꺼져 있는 경우입니다. 재부팅 후 BIOS 진입 키(보통 F2, Del, F10 중 하나)를 눌러 Virtualization Technology 항목을 켜주시면 바로 해결됩니다.
WSL2 커널 업데이트 오류가 뜨는 경우에는 마이크로소프트 공식 WSL2 리눅스 커널 업데이트 패키지를 따로 설치해주시면 됩니다.
네트워크 연결이 안 되는 경우는 방화벽이나 VPN 설정이 WSL의 가상 네트워크 어댑터와 충돌하는 경우가 많으니, 사용 중인 VPN을 잠시 꺼보고 테스트해보시는 걸 권해드려요.
VS Code, Docker와 함께 쓰기
VS Code에 ‘Remote – WSL’ 확장을 설치하면, 윈도우 탐색기가 아니라 리눅스 파일 시스템 안에서 바로 코드를 열고 편집할 수 있어서 성능 차이가 확실히 느껴집니다.
Docker Desktop을 사용 중이라면 설정에서 ‘Use WSL 2 based engine’을 켜주는 것만으로 컨테이너 실행 속도가 눈에 띄게 빨라집니다.
WSL 삭제 및 초기화하는 법
특정 배포판만 지우고 싶다면 아래 명령어를 사용합니다.
wsl --unregister UbuntuWSL 기능 자체를 완전히 끄고 싶다면 ‘제어판 > 프로그램 > Windows 기능 켜기/끄기’에서 ‘Linux용 Windows 하위 시스템’과 ‘가상 머신 플랫폼’ 체크를 해제하고 재부팅하면 됩니다.
자주 묻는 질문(FAQ)
Q1. WSL1과 WSL2 중 뭘 써야 하나요?
특별한 호환성 문제가 없다면 WSL2를 사용하시는 게 속도와 호환성 면에서 유리합니다.
Q2. 설치 후 우분투가 실행되지 않아요.
BIOS에서 가상화가 꺼져 있거나, WSL2 커널 업데이트가 안 된 경우가 대부분입니다. 위 트러블슈팅 항목을 순서대로 확인해보세요.
Q3. 윈도우 파일과 리눅스 파일을 서로 접근할 수 있나요?
네, 윈도우 탐색기에서 \\wsl$ 경로로 리눅스 파일에 접근할 수 있고, 리눅스 터미널에서는 /mnt/c/ 경로로 윈도우 드라이브에 접근할 수 있습니다.
Q4. 여러 개의 리눅스 배포판을 동시에 설치해도 되나요?
네, wsl --list --online 명령어로 설치 가능한 배포판 목록을 확인하고, 필요한 만큼 설치해서 wsl -d 배포판이름으로 전환하며 사용할 수 있습니다.
Q5. WSL 메모리 사용량이 너무 많아요.
사용자 폴더에 .wslconfig 파일을 만들어 메모리와 CPU 사용량을 제한할 수 있습니다. 예를 들어 메모리를 4GB로 제한하고 싶다면 파일 안에 memory=4GB를 입력하면 됩니다.
함께 보면 좋은 글
얀덱스 같은 사이트 5곳ㅣ구글 대체 검색엔진 비교 2026