Как установить WSL на Windows

Что нужно для WSL

• Windows 11 или Windows 10 версии 2004 (сборка 19041) и новее. Свою версию покажет команда winver в меню «Пуск».
• Учётная запись администратора: установка включает компоненты Windows.
• Для WSL 2 — виртуализация, включённая в BIOS или UEFI. Проверьте в «Диспетчере задач» › «Производительность» › «ЦП»: в строке «Виртуализация» должно быть «Включено».

Как установить WSL одной командой

Щёлкните правой кнопкой по «Пуску» и выберите «Терминал (Администратор)». Выполните команду и, когда она закончит, перезагрузите Windows. Она включает компоненты «Подсистема Windows для Linux» и «Платформа виртуальной машины», ставит ядро Linux, делает WSL 2 версией по умолчанию и устанавливает Ubuntu.

Если команда только выводит справку WSL, сама WSL уже есть, не хватает лишь дистрибутива. Поставьте его, как в следующем разделе.

Как выбрать другой дистрибутив Linux

Первая команда покажет дистрибутивы, которые можно поставить, с именами вроде Ubuntu-24.04, Debian или kali-linux. Вторая установит тот, что вы назовёте. Можно держать несколько сразу.

Просто Ubuntu — это текущий выпуск LTS. Имя с номером, например Ubuntu-24.04, даёт ровно этот выпуск. Чтобы команда wsl открывала другой дистрибутив, выполните:

Как создать пользователя Linux

После перезагрузки Ubuntu откроется сама, или откройте её из меню «Пуск». Минуту она распаковывается, а потом просит User Name и Password.

• Имя никак не связано с учётной записью Windows. Берите строчные латинские буквы, например alex.
• Пока вы вводите пароль, на экране ничего не появляется — так и должно быть. Пароль нужен для sudo: этот пользователь — администратор в Linux.
• У каждого дистрибутива свои пользователи. Новый или сброшенный дистрибутив спросит снова.
• Забыли пароль? Откройте Linux от имени root в Терминале: wsl -u root Затем задайте новый пароль, подставив своё имя пользователя вместо alex: passwd alex

Пакеты Linux Windows не обновляет. Время от времени делайте это сами в терминале Ubuntu:

WSL 1 или WSL 2: как проверить и переключить

Первая команда покажет ваши дистрибутивы и версию WSL у каждого. Вторая переведёт дистрибутив на WSL 2, третья сделает WSL 2 версией по умолчанию для новых. Последняя обновит саму WSL.

WSL 2 запускает настоящее ядро Linux в лёгкой виртуальной машине. В ней работает всё, включая Docker, а файлы внутри Linux открываются быстро. WSL 1 не нужна виртуализация, и файлы на дисках Windows она читает быстрее, но некоторые программы в ней не запускаются. Для разработки берите WSL 2 и держите проекты в домашней папке Linux, а не в /mnt/c.

Прежде чем остановить все дистрибутивы и виртуальную машину WSL, сохраните работу в Linux: открытые там программы закроются. Останавливает их команда: wsl --shutdown

Частые проблемы при установке WSL

• WSL2 is unable to start since virtualization is not enabled on this machine. с кодом ошибки HCS_E_HYPERV_NOT_INSTALLED (текущая WSL) или Error: 0x80370102 The virtual machine could not be started because a required feature is not installed. (старые версии) — включите виртуализацию в BIOS или UEFI (часто она называется Intel VT-x, AMD-V или SVM) и компонент «Платформа виртуальной машины», затем перезагрузитесь. Проверьте настройку гипервизора: bcdedit /enum | findstr -i hypervisorlaunchtype Если там Off, Microsoft советует выполнить в Терминале от имени администратора эту команду и перезагрузиться: bcdedit /set hypervisorlaunchtype Auto Внутри виртуальной машины WSL 2 нужна ещё вложенная виртуализация, её включают в настройках хоста.
• WslRegisterDistribution failed with error: 0x8007019e — выключен компонент «Подсистема Windows для Linux». Включите его в окне «Включение или отключение компонентов Windows» и перезагрузитесь или снова запустите установку: wsl --install
• Installation failed with error 0x80070003 — WSL работает только с системного диска. В «Параметрах» › «Система» › «Память» › «Дополнительные параметры хранилища» › «Место сохранения нового содержимого» выберите для новых приложений диск C:.
• Установка зависла на 0.0% — сначала скачайте дистрибутив: wsl --install --web-download -d Ubuntu
• WSL 2 не запускается на старом процессоре — ей нужен SLAT, он есть у Intel Core начиная с первого поколения и у AMD Opteron. На более старых работает только WSL 1.
• При других ошибках поставьте обновления Windows и обновите WSL: wsl --update Страница устранения неполадок Microsoft ещё советует починить системные файлы в Терминале от имени администратора: sfc /scannow

Оба компонента можно включить и командами со страницы ручной установки Microsoft — в Терминале от имени администратора, затем перезагрузка: