WSL 설치가 막힐 때, 점검 순서대로 풀어가기

설치 안내대로 따라 했는데 중간에 오류가 나거나 진행이 멈추면, 입문자 입장에서는 어디가 문제인지 가늠하기 어렵습니다. 이럴 때 필요한 것은 더 많은 검색이 아니라 점검 순서입니다. 원인이 될 만한 항목을 위에서부터 하나씩 지워 나가면, 대부분의 문제는 몇 단계 안에서 좁혀집니다. 아래 순서는 위쪽일수록 더 흔하고, 더 근본적인 원인입니다.

먼저: 한 번에 하나씩만 바꾼다

문제 해결의 가장 흔한 실수는 “안 되니까 이것저것 동시에 바꾸는 것”입니다. 그러면 무엇이 원인이었는지 알 수 없게 됩니다. 한 가지를 바꾸고 다시 시도하고, 그래도 안 되면 되돌린 뒤 다음 항목으로 넘어가세요. 변경 → 시도 → 결과 확인. 이 작은 리듬을 지키는 것만으로도 헤매는 시간이 크게 줄어듭니다.

또 하나, 오류 메시지를 끝까지 읽는 습관을 들이세요. 메시지에는 원인이나 다음 행동의 힌트가 적혀 있는 경우가 많습니다. 메시지 전문을 그대로 검색하면, 짐작으로 손대는 것보다 정확한 단서를 얻습니다.

점검 1 — 가상화가 켜져 있는가

WSL2는 가벼운 가상화를 사용합니다. 이 기능이 꺼져 있으면 설치가 끝까지 진행되지 않습니다. 작업 관리자의 성능 탭에서 가상화 항목이 “사용”으로 표시되는지 먼저 확인하세요. 꺼져 있다면 메인보드 펌웨어(BIOS/UEFI) 설정에서 가상화 옵션을 켜야 할 수 있습니다.

가상화 옵션의 이름은 제조사마다 다릅니다. 인텔은 보통 VT-x(또는 Virtualization Technology), AMD는 SVM(또는 AMD-V)으로 표기됩니다. 또한 일부 보안 소프트웨어나 다른 가상화 프로그램이 가상화 자원을 점유해 충돌하는 경우도 있으니, 설정을 켰는데도 안 된다면 그쪽도 의심해 보세요.

점검 2 — 필요한 윈도우 기능이 켜져 있는가

WSL은 몇 가지 윈도우 선택 기능에 의존합니다. 최신 버전에서는 wsl --install이 이를 자동으로 켜주지만, 환경에 따라 수동으로 활성화해야 할 때가 있습니다. “Windows 기능 켜기/끄기” 화면에서 관련 기능이 체크되어 있는지 확인하세요. 기능을 켠 뒤에는 반드시 재부팅하고 다시 시도해야 합니다. 재부팅을 건너뛰면 분명히 켰는데도 적용이 안 된 것처럼 보입니다.

점검 3 — 윈도우가 최신 상태인가

명령 자체가 “알 수 없는 명령”으로 인식된다면 윈도우 버전이 오래된 경우가 많습니다. 윈도우 업데이트를 끝까지 적용한 뒤 다시 시도해 보세요. 업데이트는 한 번에 끝나지 않고, 적용 후 재부팅하면 또 다른 업데이트가 줄지어 나오기도 합니다. 더 이상 새 업데이트가 없을 때까지 반복하는 것이 안전합니다.

점검 4 — 배포판 내려받기가 멈추는가

설치는 시작됐는데 우분투 내려받기에서 멈춘다면 네트워크나 일시적인 서버 문제일 수 있습니다. 잠시 후 다시 시도하거나, 설치 가능한 목록을 확인한 뒤 배포판을 명시적으로 지정해 설치하는 방법도 있습니다.

wsl --list --online        # 설치 가능한 배포판 목록 확인
wsl --install -d Ubuntu    # 배포판을 직접 지정해 설치

사내망이나 프록시 환경에서는 내려받기가 자주 막힙니다. 다른 네트워크(예: 일반 가정망)에서 시도하면 원인이 네트워크 쪽인지 빠르게 가려낼 수 있습니다.

점검 5 — 그래도 안 되면 상태를 확인한다

현재 WSL이 어떤 상태인지 확인하면 다음 단서를 얻을 수 있습니다. 기본 버전이 WSL2로 잡혀 있는지, 커널 버전은 무엇인지 등을 보여 줍니다.

wsl --status     # 기본 배포판·버전 등 현재 상태
wsl --version    # WSL 및 커널 버전 정보

여기서 나오는 정보를 바탕으로 검색하면, 막연히 오류 메시지만 검색할 때보다 훨씬 정확한 해결책을 찾게 됩니다.

점검 6 — 한번 완전히 내렸다가 다시 시도한다

설정은 맞는 것 같은데 동작이 어딘가 꼬인 느낌이라면, WSL을 완전히 종료한 뒤 다시 시작해 보세요. 백그라운드에 남아 있던 상태가 정리되면서 풀리는 경우가 있습니다.

wsl --shutdown   # 실행 중인 모든 배포판과 WSL을 종료

이 명령은 실행 중인 작업을 모두 끝내므로, 저장하지 않은 작업이 있다면 먼저 정리한 뒤 실행하세요. 종료 후 잠시 기다렸다가 다시 시도하면 됩니다.

초보자가 자주 막히는 부분

• 오류 메시지를 끝까지 읽지 않음 — 메시지 안에 이미 원인이 적혀 있는 경우가 많습니다.
• 재부팅을 생략 — 기능을 켜거나 업데이트한 뒤에는 재부팅이 필요합니다.
• 여러 해결책을 동시에 적용 — 무엇이 효과가 있었는지 알 수 없게 됩니다.
• 관리자 권한 없이 실행 — 일부 단계는 관리자 권한 터미널이 필요합니다.
• 프록시·사내망을 의심하지 않음 — 내려받기 멈춤의 흔한 원인입니다.

정리

설치 문제는 대부분 가상화, 윈도우 기능, 업데이트 중 하나에서 비롯됩니다. 당황해서 여기저기 손대기보다, 위에서부터 한 항목씩 점검하면 원인을 빠르게 좁힐 수 있습니다. 점검해도 풀리지 않을 때는 wsl --status로 상태를 확인하고, wsl --shutdown으로 한번 완전히 내렸다가 다시 시도하세요. 이 점검 순서를 몸에 익혀 두면 앞으로 다른 도구를 설치할 때도 같은 방식으로 침착하게 풀어갈 수 있습니다.