Команда wsl --install в Windows 10 не срабатывает на старых сборках системы — вместо установки терминал выводит справку по командам WSL, и пользователи принимают это за ошибку. На самом деле упрощённая установка одной командой появилась только в свежих версиях Windows 10 (начиная со сборки 19041 и выше, при условии установленных обновлений), а на более ранних выпусках подсистему приходится включать вручную через компоненты Windows и PowerShell.
В этой инструкции разберём оба сценария: быструю установку через одну команду и классический ручной способ для старых сборок. Отдельно разберём, как проверить версию WSL, обновить ядро и что делать, если при запуске дистрибутива появляются ошибки виртуализации.
Что такое WSL и какую версию выбрать
WSL (Windows Subsystem for Linux — подсистема Windows для Linux) позволяет запускать полноценное окружение Linux прямо внутри Windows 10, без установки виртуальной машины и без двойной загрузки. Можно выполнять команды bash, ставить пакеты через apt, запускать скрипты и серверные инструменты — всё это в отдельном окне терминала.
Существует две версии подсистемы, и разница между ними принципиальна:
- 🐧 WSL 1 — транслирует системные вызовы Linux в вызовы Windows. Работает быстрее при обращении к файлам Windows, но не поддерживает часть низкоуровневых функций ядра.
- 🐧 WSL 2 — использует настоящее ядро Linux, запущенное в лёгкой виртуальной машине. Полная совместимость с Docker и системными вызовами.
- 🐧 Обновление ядра — для WSL 2 требуется отдельный пакет обновления ядра Linux, который ставится поверх компонентов Windows.
Для большинства задач разработки рекомендуется именно WSL 2: он поддерживает Docker Desktop, systemd (в свежих версиях) и обеспечивает полную совместимость с Linux-инструментами. WSL 1 имеет смысл оставить только в случаях, когда критична скорость работы с файлами, лежащими на диске Windows.
Проверка системы перед установкой
Перед началом убедитесь, что система соответствует минимальным требованиям. Для WSL 1 достаточно 64-разрядной Windows 10, а для WSL 2 понадобится сборка 19041 или новее, а также включённая виртуализация в BIOS/UEFI.
Чтобы узнать версию и сборку системы, нажмите Win + R, введите winver и нажмите Enter. В появившемся окне будет указан номер версии (например, 22H2) и сборка. Если сборка ниже 19041, сначала обновите Windows через Параметры → Обновление и безопасность → Центр обновления Windows.
Виртуализацию проверяют через Диспетчер задач: вкладка «Производительность», раздел «ЦП». В правой части должно быть указано «Виртуализация: включено». Если там стоит «отключено», потребуется войти в BIOS/UEFI и активировать технологию Intel VT-x или AMD-V — название пункта зависит от производителя материнской платы, поэтому сверьтесь с документацией к вашей плате или ноутбуку.
Быстрая установка одной командой
На свежих сборках Windows 10 весь процесс сводится к одной команде. Откройте PowerShell или Командную строку от имени администратора (правый клик по меню «Пуск» → «Windows PowerShell (администратор)») и выполните:
wsl --installКоманда автоматически включает нужные компоненты («Подсистема Windows для Linux» и «Платформа виртуальной машины»), скачивает ядро WSL 2, устанавливает его версией по умолчанию и ставит дистрибутив Ubuntu. После завершения обязательно перезагрузите компьютер — без перезагрузки дистрибутив не запустится.
Если нужен другой дистрибутив, сначала посмотрите список доступных:
wsl --list --onlineЗатем укажите конкретный дистрибутив при установке, например: wsl --install -d Debian. Точные названия дистрибутивов берите из вывода первой команды — список периодически меняется.
Ручная установка на старых сборках Windows 10
На сборках младше 19041 автоматическая команда недоступна, поэтому компоненты включаются по отдельности. Все команды выполняются в PowerShell, запущенном от имени администратора.
Шаг первый — включить саму подсистему:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartШаг второй — включить платформу виртуальной машины (нужна для WSL 2):
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartПосле обеих команд перезагрузите компьютер. Затем скачайте и установите пакет обновления ядра WSL 2 с официального сайта Microsoft (он распространяется как отдельный MSI-установщик) и задайте WSL 2 версией по умолчанию:
wsl --set-default-version 2☑️ Чек-лист ручной установки WSL
Финальный шаг — установка дистрибутива. Откройте Microsoft Store, найдите нужный дистрибутив (Ubuntu, Debian, Kali Linux и другие) и нажмите «Получить». При первом запуске дистрибутив предложит создать имя пользователя и пароль — этот аккаунт не связан с учётной записью Windows.
⚠️ Внимание: пароль при вводе в терминале Linux не отображается вообще — ни звёздочками, ни точками. Это нормальное поведение, а не зависание: просто вводите пароль вслепую и нажимайте Enter.
Проверка версии и переключение между WSL 1 и WSL 2
После установки полезно убедиться, что дистрибутив работает на нужной версии подсистемы. Выполните в PowerShell:
wsl --list --verboseВ колонке VERSION будет указана версия для каждого установленного дистрибутива. Если дистрибутив оказался на WSL 1, а нужен WSL 2, конвертация выполняется командой wsl --set-version Ubuntu 2 — вместо Ubuntu подставьте имя вашего дистрибутива из вывода предыдущей команды. Конвертация занимает несколько минут, дистрибутив при этом должен быть выключен.
Обратное переключение (с WSL 2 на WSL 1) делается той же командой с параметром 1. Данные внутри дистрибутива при конвертации сохраняются, но перед операцией разумно сделать резервную копию важных файлов.
Типичные ошибки и их решение
Самая частая проблема при первом запуске — сообщение о том, что виртуализация не включена, или ошибка с упоминанием VirtualMachinePlatform. Возможная причина — отключённая виртуализация в BIOS/UEFI. Проверьте статус в Диспетчере задач и, если она отключена, включите Intel VT-x или AMD-V в настройках прошивки. Точный путь в меню BIOS зависит от производителя, поэтому сверяйтесь с инструкцией к конкретной материнской плате или ноутбуку.
Вторая распространённая ситуация — ошибка, требующая обновить ядро WSL. Она возникает, когда пакет ядра не установлен или устарел. Решение — скачать актуальный установщик ядра с сайта Microsoft либо выполнить wsl --update (на сборках, где эта команда поддерживается).
| Симптом | Возможная причина | Что проверить |
|---|---|---|
| wsl --install выводит справку | Старая сборка Windows 10 | Номер сборки через winver |
| Ошибка виртуализации при запуске | VT-x/AMD-V отключены в BIOS | Диспетчер задач → ЦП → Виртуализация |
| Требуется обновление ядра | Не установлен пакет ядра WSL 2 | Установить MSI-пакет ядра или wsl --update |
| Дистрибутив не запускается после установки | Не выполнена перезагрузка | Перезагрузить ПК и повторить запуск |
| Ошибка 0x80370102 | Проблемы с вложенной виртуализацией или её отключением | Настройки BIOS и компонент «Платформа виртуальной машины» |
⚠️ Внимание: если Windows 10 работает внутри виртуальной машины (Hyper-V, VMware, VirtualBox), WSL 2 может не запуститься — требуется поддержка вложенной виртуализации, которая включена не во всех гипервизорах. В такой ситуации используйте WSL 1 или настраивайте вложенную виртуализацию по документации конкретного гипервизора.
Как удалить или переустановить дистрибутив
Выполните wsl --unregister ИмяДистрибутива — это полностью удалит дистрибутив вместе со всеми данными внутри него. Затем установите его заново из Microsoft Store или командой wsl --install -d ИмяДистрибутива. Перед удалением экспортируйте важные данные командой wsl --export.
Первые шаги после установки
Когда дистрибутив запущен и учётная запись создана, стоит сразу обновить пакеты системы. Для Ubuntu и Debian это делается стандартной командой:
sudo apt update && sudo apt upgradeФайлы Windows доступны из Linux по пути /mnt/c (диск C:), а файлы дистрибутива из Windows — через сетевой путь \\wsl$, который можно ввести в адресной строке Проводника. Для комфортной работы также рекомендуется установить Windows Terminal из Microsoft Store — он автоматически добавляет профили всех установленных дистрибутивов WSL.
Ключевой момент производительности: рабочие проекты лучше хранить внутри файловой системы Linux (например, в домашней папке ~), а не на /mnt/c — доступ к файлам Windows из WSL 2 заметно медленнее.
Часто задаваемые вопросы
Чем WSL отличается от обычной виртуальной машины?
WSL глубже интегрирован в Windows: запускается за секунды, имеет общий доступ к файловой системе и сети, не требует ручного выделения ресурсов. Полноценная виртуальная машина даёт большую изоляцию и графический интерфейс, но тяжелее в настройке и потребляет больше ресурсов.
Работает ли WSL на Windows 10 Home?
Да, обе версии WSL работают на домашней редакции Windows 10. Компонент «Платформа виртуальной машины», необходимый для WSL 2, доступен в том числе в Windows 10 Home, в отличие от полноценного Hyper-V.
Можно ли установить несколько дистрибутивов одновременно?
Да, количество дистрибутивов не ограничено — можно держать рядом Ubuntu, Debian и другие системы. Каждый из них изолирован и имеет собственную файловую систему. Запуск конкретного дистрибутива выполняется командой wsl -d ИмяДистрибутива.
Как узнать, какие дистрибутивы уже установлены?
Выполните в PowerShell команду wsl --list --verbose — она покажет все установленные дистрибутивы, их состояние (запущен или остановлен) и версию WSL для каждого.
Нужно ли платить за WSL или дистрибутивы?
Нет. Подсистема WSL является компонентом Windows 10, а популярные дистрибутивы в Microsoft Store (Ubuntu, Debian и другие) распространяются бесплатно.