간단히 하기 위해 일반적으로 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 업데이트 도우미 사용하여 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 Platform 선택적 기능을 사용하도록 설정해야 합니다. 이 기능을 사용하려면 머신에 가상화 기능이 필요합니다.
Linux 커널 업데이트 패키지는 Windows 운영 체제 이미지 내에서 WSL을 실행하기 위한 최신 버전의 WSL 2 Linux 커널 설치합니다. (Microsoft Store 에서 더 자주 푸시되는 업데이트를 사용하여WSL을 실행하려면 wsl.exe --install를 사용하거나 wsl.exe --update를 사용하세요.)
ARM64 컴퓨터를 사용하는 경우 ARM64 패키지 다운로드하세요. 어떤 종류의 컴퓨터가 있는지 잘 모르는 경우 명령 프롬프트 또는 PowerShell을 열고 다음을 입력합니다. systeminfo | find "System Type".
주의: 영어가 아닌 Windows 버전에서는 "시스템 유형" 문자열을 번역하여 검색 텍스트를 수정해야 할 수 있습니다. 찾기 명령어에 대한 따옴표를 이스케이프해야 할 수도 있습니다. 예를 들어 독일어 systeminfo | find '"Systemtyp"'.
이전 단계에서 다운로드한 업데이트 패키지를 실행합니다. (두 번 클릭하여 실행합니다. 관리자 권한에 대한 메시지가 표시되고 이 설치를 승인하려면 '예'를 선택합니다.)
설치가 완료되면 다음 단계로 이동하여 새 Linux 배포판을 설치할 때 WSL 2를 기본 버전으로 설정합니다. (새 Linux 설치를 WSL 1로 설정하려면 이 단계를 건너뜁니다.)
축하합니다! Windows 운영 체제와 완전히 통합된 Linux 배포를 성공적으로 설치하고 설정했습니다.
설치 문제 해결
설치 프로세스 중에 문제가 발생하는 경우 문제 해결 가이드 설치 섹션을 확인하세요.
배포판 다운로드
Microsoft Store를 사용하여 WSL Linux 배포판을 설치할 수 없거나 원하지 않을 수 있는 시나리오가 있습니다. Microsoft Store를 지원하지 않는 Windows Server 또는 LTSC(Long-Term 서비스) 데스크톱 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 코드를 디버깅하고 실행하는 방법을 보여 줍니다.
wsl --install 명령을 사용하여 Linux용 Windows 하위 시스템을 설치합니다. Ubuntu, Debian, SUSE, Kali, Fedora, Pengwin, Alpine 등 원하는 Linux 배포판에서 실행되는 Windows 머신에서 Bash 터미널을 사용할 수 있습니다.
이 단계별 가이드의 모범 사례를 사용하여 WSL 개발 환경을 설정합니다. Ubuntu, Visual Studio Code 또는 Visual Studio, Git, Windows 자격 증명 관리자, MongoDB, MySQL, Docker 원격 컨테이너 등을 실행하는 방법을 알아봅니다.