WSL2 설치하는 법 - 윈도우에서 리눅스 사용하기 완벽 가이드
안녕하세요, 우리들의 주파수 구독자 여러분! 개발 공부를 시작하거나 리눅스 전용 툴을 써야 하는데 굳이 컴퓨터를 새로 사거나 듀얼부팅을 하고 싶지는 않을 때, 답은 대부분 **WSL(Windows Subsystem for Linux)**입니다. 윈도우를 그대로 쓰면서 진짜 리눅스 커널 위에서 우분투 같은 배포판을 통째로 돌릴 수 있는 마이크로소프트 공식 기능입니다. 이번 글에서는 WSL2 설치부터 실제 사용법, 그리고 설치 중 가장 자주 만나는 오류 해결법까지 한 번에 정리합니다.
WSL이란? WSL1과 WSL2 차이
WSL은 윈도우 안에서 리눅스 배포판(우분투, 데비안 등)을 별도의 가상머신처럼 무겁지 않게 실행해주는 호환 레이어입니다. 버전이 두 가지 있는데 차이를 알아야 헷갈리지 않습니다.
| 구분 | WSL1 | WSL2 |
|---|---|---|
| 방식 | 윈도우 커널 위에서 리눅스 시스템 콜을 변환 | 실제 경량 리눅스 커널을 가상화 기술로 구동 |
| 호환성 | 일부 리눅스 전용 기능(도커 등) 미지원 | 대부분의 리눅스 기능 완전 호환 |
| 파일 I/O 속도 | 윈도우 파일 시스템 접근 시 빠름 | 리눅스 파일 시스템(\\wsl$) 내부 작업이 훨씬 빠름 |
| 메모리 사용 | 필요한 만큼만 사용 | 가상머신 기반이라 상대적으로 더 사용 |
| 도커(Docker) | 사실상 불가 | Docker Desktop 필수 요구사항 |
결론부터 말하면, 2026년 현재는 그냥 WSL2를 쓰면 됩니다. WSL1은 특수한 상황(구형 CPU, 가상화 미지원 환경)이 아니면 고려할 이유가 거의 없습니다.
설치 전 확인 사항
- 윈도우 버전: 윈도우 11 또는 윈도우 10 버전 2004(빌드 19041) 이상.
Win + R→winver입력으로 확인. - 가상화 지원: CPU가 가상화 기술(Intel VT-x, AMD-V)을 지원해야 하며, BIOS/UEFI에서 가상화가 켜져 있어야 합니다. 작업 관리자 → 성능 탭 → CPU 항목에서 “가상화: 사용” 여부로 확인할 수 있습니다. “사용 안 함”이면 재부팅 후 BIOS 설정(제조사마다 다르지만 보통
Intel Virtualization Technology또는SVM Mode항목)에서 켜줘야 합니다. - 관리자 권한: 설치 명령은 관리자 권한 터미널에서 실행해야 합니다.
WSL2 설치하는 법 (초간단 버전)
윈도우 10 버전 2004 이상, 윈도우 11이라면 명령어 한 줄로 끝납니다.
1단계. PowerShell을 관리자 권한으로 실행
시작 메뉴에서 “PowerShell” 검색 → 마우스 오른쪽 클릭 → 관리자 권한으로 실행을 선택합니다.
2단계. 설치 명령 실행
wsl --install이 한 줄이면 다음이 자동으로 처리됩니다.
- WSL과 가상 머신 플랫폼 기능 활성화
- 최신 리눅스 커널 다운로드 및 설치
- WSL2를 기본 버전으로 설정
- 기본 배포판(우분투) 다운로드 및 설치
3단계. 재부팅
설치가 끝나면 컴퓨터를 재부팅해야 합니다. 재부팅 후 자동으로 우분투 설치가 마무리되면서 터미널 창이 뜨고, 리눅스용 사용자 이름과 비밀번호를 입력하라고 나옵니다. 원하는 대로 입력하면 완료입니다(윈도우 계정과는 별개입니다).
특정 배포판을 지정해서 설치하고 싶다면
기본값은 우분투지만, 데비안·칼리 리눅스 등 다른 배포판도 고를 수 있습니다.
# 설치 가능한 배포판 목록 확인
wsl --list --online
# 원하는 배포판 설치 (예: 데비안)
wsl --install -d Debian설치 후 기본 사용법
리눅스 터미널 실행
시작 메뉴에서 설치한 배포판 이름(예: “Ubuntu”)을 검색해 실행하거나, 아무 터미널에서 wsl 명령을 입력하면 바로 리눅스 셸로 들어갑니다.
윈도우 ↔ 리눅스 파일 서로 접근하기
- 윈도우 탐색기에서 리눅스 파일 보기: 주소창에
\\wsl$입력, 또는 리눅스 터미널에서explorer.exe .입력하면 현재 폴더가 탐색기로 열립니다. - 리눅스에서 윈도우 파일 접근: 윈도우 드라이브는
/mnt/c/,/mnt/d/형태로 자동 마운트됩니다. 단, 성능이 중요한 개발 작업(git clone, npm install 등)은 반드시 윈도우 드라이브(/mnt/c/...)가 아니라 **리눅스 파일 시스템 내부(/home/사용자명/...)**에서 진행해야 체감 속도가 몇 배 차이 납니다.
패키지 설치와 업데이트
일반 리눅스와 동일하게 사용합니다. 우분투 기준:
sudo apt update && sudo apt upgrade -y
sudo apt install git curl build-essential -yVS Code와 연동하기
VS Code에 **WSL 확장(Remote - WSL)**을 설치하면, 리눅스 터미널에서 code .만 입력해도 해당 폴더가 VS Code로 열리면서 원격 개발 환경처럼 동작합니다. 파일은 리눅스 안에 있지만 편집은 윈도우의 VS Code UI로 그대로 하는 방식이라 실무에서 가장 많이 쓰는 조합입니다.
배포판 관리 명령어
wsl --list --verbose # 설치된 배포판과 버전(1/2) 확인
wsl --set-version Ubuntu 2 # 특정 배포판을 WSL2로 전환
wsl --set-default Ubuntu # 기본 배포판 지정
wsl --shutdown # WSL 전체 종료(메모리 회수)
wsl --unregister Ubuntu # 배포판 완전 삭제(초기화 목적)자주 발생하는 오류와 해결법
오류 1. “WslRegisterDistribution failed with error: 0x8007019e”
WSL 최적화 기능(가상 머신 플랫폼)이 켜져 있지 않을 때 발생합니다. 관리자 권한 PowerShell에서 아래 명령을 순서대로 실행하고 재부팅합니다.
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart오류 2. “0x80370102 - 가상 머신을 시작할 수 없습니다”
CPU 가상화가 BIOS에서 꺼져 있을 때 나는 오류입니다. 재부팅 후 BIOS/UEFI 설정에 들어가 Intel VT-x, AMD-V, SVM Mode 중 해당하는 항목을 활성화합니다. 일부 노트북은 제조사 전용 유틸리티(레노버 Vantage, 델 SupportAssist 등)에서 대신 켤 수 있는 경우도 있습니다.
오류 3. “네트워크에 연결할 수 없습니다 / DNS 조회 실패”
VPN이나 회사 방화벽 환경에서 흔합니다. 우선 wsl --shutdown 후 재시작해보고, 그래도 안 되면 사용자 폴더(C:\Users\사용자명\)에 .wslconfig 파일을 만들고 아래 내용을 넣어 네트워크 모드를 바꿔봅니다.
[wsl2]
networkingMode=mirrored저장 후 wsl --shutdown으로 재시작하면 적용됩니다.
오류 4. Vmmem 프로세스가 메모리를 너무 많이 먹음
WSL2는 백그라운드에서 Vmmem이라는 프로세스로 메모리를 점유합니다. 방치하면 계속 늘어나는 경우가 있는데, 사용자 폴더에 .wslconfig 파일을 만들어 상한선을 정해주면 해결됩니다.
[wsl2]
memory=4GB
processors=4
swap=2GB숫자는 본인 PC 사양에 맞게 조정하면 됩니다. 저장 후 wsl --shutdown으로 재시작해야 반영됩니다.
오류 5. 설치 명령 자체가 “이 명령을 인식할 수 없습니다”로 실패
윈도우 버전이 너무 오래됐을 가능성이 높습니다. 윈도우 10 버전 2004 미만이라면 wsl --install 대신 마이크로소프트 공식 수동 설치 가이드를 따라 기능 활성화 → 커널 업데이트 패키지 별도 다운로드 → 배포판 설치 순서로 진행해야 합니다. 가장 간단한 해결책은 Windows Update로 윈도우를 최신 버전까지 올리는 것입니다.
WSL2 vs 가상머신(VirtualBox·VMware) vs 듀얼부팅
| 방식 | 속도 | 설정 난이도 | 윈도우와 파일 공유 | 이럴 때 추천 |
|---|---|---|---|---|
| WSL2 | 빠름(네이티브에 가까움) | 매우 쉬움 | 매우 쉬움(/mnt/c, \\wsl$) | 개발·서버 테스트·CLI 툴 사용 |
| 가상머신(VirtualBox 등) | 느림(리소스 별도 할당) | 보통 | 폴더 공유 설정 필요 | 리눅스 데스크톱 GUI를 온전히 써야 할 때 |
| 듀얼부팅 | 가장 빠름(네이티브) | 어려움 | 파티션 나눠야 함 | 리눅스를 메인 OS급으로 상시 사용할 때 |
개발 공부, 도커, 서버 배포 전 테스트 정도의 목적이라면 WSL2가 압도적으로 편합니다. 리눅스 데스크톱 환경(GUI) 자체가 필요하다면 가상머신이나 듀얼부팅이 낫습니다.
FAQ
Q. WSL2에서 우분투 데스크톱 화면(GUI)도 쓸 수 있나요?
A. 네. WSLg가 기본 내장되어 있어 sudo apt install ubuntu-desktop 같은 GUI 앱을 설치하면 윈도우 바탕화면 위에 별도 창으로 리눅스 앱이 그대로 뜹니다. 별도의 X서버 설정이 필요 없습니다.
Q. 도커(Docker Desktop)를 쓰려면 WSL2가 꼭 필요한가요? A. 네. Docker Desktop for Windows는 WSL2를 백엔드로 사용합니다. WSL2 설치 후 Docker Desktop 설정에서 “Use the WSL 2 based engine”이 켜져 있는지 확인하면 됩니다.
Q. WSL을 삭제하고 싶어요.
A. wsl --unregister 배포판이름으로 개별 배포판을 지우거나, 설정 → 앱 → “선택적 기능”에서 “Linux용 Windows 하위 시스템”과 “가상 머신 플랫폼”을 모두 끄면 완전히 제거됩니다.
Q. WSL1과 WSL2 중 뭘 써야 하나요?
A. 특별한 이유가 없다면 WSL2입니다. 다만 안티바이러스나 보안 소프트웨어가 파일 접근을 매번 검사해 윈도우 드라이브(/mnt/c) I/O가 유독 느리다고 느껴지는 특수한 경우에만 WSL1을 고려할 만합니다.
Q. 여러 개의 리눅스 배포판을 동시에 설치해도 되나요?
A. 네, 우분투와 데비안을 동시에 설치해서 용도별로 나눠 써도 문제없습니다. wsl -d 배포판이름으로 원하는 배포판을 지정해 실행할 수 있습니다.
핵심 요약
- 윈도우 11 / 윈도우 10(2004 이상)에서는 관리자 권한 PowerShell에
wsl --install한 줄이면 WSL2 + 우분투가 자동 설치된다. - 설치 오류 대부분은 가상화 미지원(BIOS) 또는 가상 머신 플랫폼 기능 비활성화가 원인이다.
- 개발 파일은 반드시 리눅스 파일 시스템(
/home/...) 내부에 두어야 속도가 빠르다. - 메모리·네트워크 문제는 사용자 폴더의
.wslconfig파일로 대부분 해결된다. - VS Code의 Remote - WSL 확장을 함께 쓰면 윈도우 UI로 리눅스 개발 환경을 그대로 다룰 수 있어 실무 조합으로 가장 추천된다.