간단하게 하려면 일반적으로 wsl --install을 사용하여 Linux용 Windows 하위 시스템을 설치하는 것이 좋지만, 이전 빌드의 Windows를 실행하는 경우에는 수동 설치 단계가 지원되지 않을 수 있습니다. 아래에 수동 설치 단계가 설명되어 있습니다. 설치 과정에서 문제가 발생하는 경우 문제 해결 가이드의 설치 섹션을 참조하세요.
1단계 - Linux용 Windows 하위 시스템 사용
Windows에서 Linux 배포를 설치하려면 먼저 "Linux용 Windows 하위 시스템" 옵션 기능을 사용하도록 설정합니다.
PowerShell을 관리자 권한(시작 메뉴 > PowerShell >에서 관리자 권한으로 실행 >을 마우스 오른쪽 단추로 클릭)으로 열고 다음 명령을 입력합니다.
이제 2단계로 이동하여 WSL 2로 업데이트하는 것이 좋습니다. 그러나 WSL 1만 설치하려면 이제 머신을 다시 시작하여 6단계 - 선택한 Linux 배포 설치로 이동할 수 있습니다. WSL 2로 업데이트하려면 머신이 다시 시작될 때까지 기다린 후 다음 단계로 이동합니다.
2단계 - WSL 2 실행을 위한 요구 사항 확인
WSL 2로 업데이트하려면 Windows 10을 실행해야 합니다.
x64 시스템의 경우: 버전 1903 이상, 빌드 18362.1049 이상.
ARM64 시스템의 경우: 버전 2004 이상, 빌드 19041 이상
또는 Windows 11.
참고
18362보다 낮은 빌드는 WSL 2를 지원하지 않습니다. Windows Update Assistant를 사용하여 Windows 버전을 업데이트합니다. Windows 버전 1903 지원은 x64 시스템에만 적용됩니다. Arm64 버전 Windows를 사용하는 경우 WSL 2에 대한 모든 권한을 얻으려면 Windows 10 버전 2004 이상으로 업그레이드해야 합니다. 자세한 내용은 Windows 10 버전 1903 및 1909에 제공되는 WSL 2 지원을 참조하세요.
버전 및 빌드 번호를 확인하려면 Windows 로고 키 + R을 선택하고, winver를 입력하고, 확인을 선택합니다. [설정] 메뉴에서 최신 Windows 버전으로 업데이트합니다.
참고
Windows 10 버전 1903 또는 1909를 실행하고 있는 경우 Windows 메뉴에서 "설정"을 열고, "업데이트 및 보안"으로 이동한 다음, "업데이트 확인"을 선택합니다. 빌드 번호는 18362.1049 이상 또는 18363.1049 이상이고, 부 빌드 번호는 .1049 이상이어야 합니다. 자세한 정보: WSL 2 지원이 Windows 10 버전 1903 및 1909에 제공됨.
3단계 - Virtual Machine 기능 사용
WSL 2를 설치하려면 먼저 Virtual Machine 플랫폼 옵션 기능을 사용하도록 설정해야 합니다. 이 기능을 사용하려면 머신에 가상화 기능이 필요합니다.
Linux 커널 업데이트 패키지는 Windows 운영 체제 이미지 내에서 WSL을 실행하기 위해 WSL 2 Linux 커널의 최신 버전을 설치합니다. (더 자주 푸시되는 업데이트와 함께 Microsoft Store에서 WSL을 실행하려면 wsl.exe --install 또는 wsl.exe --update을(를) 사용합니다.)
ARM64 머신을 사용하는 경우 ARM64 패키지를 대신 다운로드하세요. 사용하고 있는 머신의 종류를 잘 모르는 경우 명령 프롬프트 또는 PowerShell을 열고 systeminfo | find "System Type"을 입력합니다. 주의: 비 영어 Windows 버전에서는 "시스템 유형" 문자열을 변환하여 검색 텍스트를 수정해야 할 수 있습니다. find 명령에 대한 따옴표는 이스케이프해야 할 수도 있습니다. 예를 들어 독일어 systeminfo | find '"Systemtyp"'입니다.
이전 단계에서 다운로드한 업데이트 패키지를 실행합니다. (실행하려면 두 번 클릭 - 관리자 권한을 요구하는 메시지가 표시되면 '예'를 선택하여 이 설치를 승인합니다.)
설치가 완료되면 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정하는 다음 단계로 이동합니다. (새 Linux 설치를 WSL 1로 설정하려면 이 단계를 건너뜁니다.)
Microsoft Store를 사용하여 WSL Linux 배포판을 설치할 수 없는(또는 설치하고 싶지 않은) 몇 가지 시나리오가 있습니다. 사용자가 Microsoft Store를 지원하지 않는 Windows Server 또는 LTSC(장기 서비스) 데스크톱 OS SKU를 실행하고 있거나, 회사 네트워크 정책 및/또는 관리자가 사용자 환경에서 Microsoft Store 사용을 허용하지 않는 경우입니다. 이러한 경우 WSL 자체는 제공되지만 Linux 배포판을 직접 다운로드해야 할 수도 있습니다.
Microsoft Store 앱을 사용할 수 없는 경우 다음 링크를 사용하여 Linux 배포판을 다운로드하고 수동으로 설치하면 됩니다.
Windows 터미널을 사용하면 여러 탭 또는 창을 열어 여러 Linux 배포판 또는 다른 명령줄(PowerShell, 명령 프롬프트, Azure CLI 등)을 표시하고 빠르게 전환할 수 있습니다. 고유한 색 구성표, 글꼴 스타일, 크기, 배경 이미지 및 사용자 지정 바로 가기 키를 사용하여 터미널을 원하는 대로 사용자 지정할 수 있습니다. 자세한 정보
이 모듈에서는 VS Code(Visual Studio Code)와 함께 WSL(Linux용 Windows 하위 시스템)을 사용하는 방법을 알아봅니다. 설치 프로세스와 WSL 사용의 기본 사항을 살펴봅니다. 또한 Visual Studio Code WSL 확장을 설치하고 활용합니다. 마지막으로 WSL 환경 내 VS Code에서 Python 코드를 디버깅하고 실행하는 방법을 보여 줍니다.