Команда wsl --install завершается ошибкой на части машин с Windows 10, потому что эта упрощённая установка доступна не во всех сборках системы — на старых версиях компоненты придётся включать вручную через PowerShell. Прежде чем начинать, проверьте свою версию ОС: нажмите Win + R, введите winver и посмотрите номер сборки. Для WSL 2 требуется Windows 10 версии 2004 (сборка 19041) или новее для 64-разрядных систем.
WSL 2 (Windows Subsystem for Linux) позволяет запускать полноценное ядро Linux прямо внутри Windows без классической виртуальной машины. Это удобно для разработчиков, которым нужны bash, Docker, git и другие инструменты Linux-экосистемы. Ниже разберём весь процесс: от проверки требований до установки дистрибутива и решения типичных ошибок.
Системные требования и подготовка
Для работы WSL 2 необходима поддержка аппаратной виртуализации — технологии Intel VT-x или AMD-V. Проверить её активность можно через Диспетчер задач: откройте вкладку «Производительность», выберите «ЦП» и посмотрите строку «Виртуализация». Если там указано «Включено» — можно переходить к установке.
Если виртуализация отключена, её нужно активировать в BIOS/UEFI. Конкретный пункт меню зависит от производителя материнской платы: обычно это разделы вроде Advanced → CPU Configuration с параметром Intel Virtualization Technology или SVM Mode. Точное расположение сверьте с документацией вашей платы или ноутбука.
- 🖥️ Windows 10 версии 2004 (сборка 19041) или новее, 64-битная редакция
- ⚙️ Включённая виртуализация в BIOS/UEFI (VT-x или AMD-V)
- 💾 Достаточно свободного места на системном диске для дистрибутива
- 🔑 Права администратора для выполнения команд установки
⚠️ Внимание: на устройствах с Windows 10 Home WSL 2 работает, но требует компонента «Платформа виртуальной машины». Убедитесь, что система обновлена через Центр обновления Windows, иначе нужный компонент может отсутствовать.
Проверка версии Windows 10
Первый шаг — убедиться, что система соответствует минимальным требованиям. Нажмите Win + R, введите команду winver и нажмите Enter. В открывшемся окне отобразится версия и номер сборки. Вам нужна сборка 19041 или выше — именно с неё начинается официальная поддержка WSL 2 на архитектуре x64.
Если сборка старее, откройте Параметры → Обновление и безопасность → Центр обновления Windows и установите все доступные обновления. В некоторых случаях крупное обновление версии предлагается отдельной кнопкой «Скачать и установить». После обновления перезагрузите компьютер и снова проверьте номер сборки.
Быстрая установка одной командой
На актуальных сборках Windows 10 Microsoft добавила упрощённый способ установки. Запустите PowerShell от имени администратора (правый клик по меню «Пуск» → «Windows PowerShell (администратор)») и выполните:
wsl --installЭта команда автоматически включает необходимые компоненты, скачивает ядро Linux, устанавливает WSL 2 как версию по умолчанию и разворачивает дистрибутив Ubuntu. После завершения потребуется перезагрузка компьютера. При первом запуске Ubuntu система попросит создать имя пользователя и пароль для Linux-окружения — они не связаны с вашей учётной записью Windows.
Если команда возвращает ошибку или сообщение, что wsl не распознана, значит, ваша сборка не поддерживает упрощённый сценарий. В этом случае переходите к ручной установке из следующего раздела.
Ручная установка WSL 2 через PowerShell
Ручной способ состоит из нескольких последовательных шагов. Все команды выполняются в PowerShell с правами администратора. Сначала включите компонент «Подсистема Windows для Linux»:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartЗатем включите Платформу виртуальной машины — именно она обеспечивает работу ядра Linux в WSL 2:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartПосле выполнения обеих команд перезагрузите компьютер — без этого компоненты не активируются. Далее нужно установить пакет обновления ядра WSL 2: скачайте его с официального сайта Microsoft (страница документации по установке WSL содержит актуальную ссылку на MSI-пакет) и установите как обычную программу.
Финальный шаг — назначить WSL 2 версией по умолчанию:
wsl --set-default-version 2☑️ Чек-лист ручной установки WSL 2
Установка дистрибутива Linux
После настройки самой подсистемы нужно установить конкретный дистрибутив. Откройте Microsoft Store и в поиске введите название — например, Ubuntu, Debian или Kali Linux. Нажмите «Получить» и дождитесь загрузки. Посмотреть доступные варианты можно также командой wsl --list --online в PowerShell.
При первом запуске дистрибутив распакуется и предложит создать пользователя. Придумайте имя (строчными латинскими буквами) и пароль — при вводе пароля символы не отображаются, это нормальное поведение терминала Linux. Убедиться, что дистрибутив работает именно на WSL 2, можно командой:
wsl -l -vОна покажет список установленных дистрибутивов и версию WSL для каждого. Если в колонке VERSION стоит 1, переключите дистрибутив на вторую версию командой wsl --set-version ИмяДистрибутива 2, подставив точное имя из вывода предыдущей команды.
Чем WSL 2 отличается от WSL 1
WSL 1 транслирует системные вызовы Linux в вызовы Windows, а WSL 2 использует настоящее ядро Linux в лёгкой виртуальной машине. Это даёт полную совместимость с Linux-приложениями (включая Docker) и заметно более быструю работу с файловой системой, хотя доступ к файлам Windows из WSL 2 может быть медленнее, чем в WSL 1.
Сравнение WSL 1 и WSL 2
| Критерий | WSL 1 | WSL 2 |
|---|---|---|
| Ядро Linux | Эмуляция вызовов | Настоящее ядро в ВМ |
| Совместимость приложений | Частичная | Полная |
| Скорость работы с файлами Linux | Средняя | Высокая |
| Поддержка Docker | Нет | Да |
| Требования к виртуализации | Не требуется | Обязательна |
Для большинства задач разработки предпочтителен WSL 2 — особенно если планируется использовать Docker Desktop, который опирается именно на эту версию. WSL 1 имеет смысл оставить только в специфических сценариях, где критична скорость доступа к файлам на диске Windows.
Типичные ошибки и их решение
Одна из самых частых проблем — ошибка, сообщающая, что виртуализация не включена, при попытке запустить дистрибутив. Вернитесь в BIOS/UEFI и проверьте параметры VT-x/SVM, а также убедитесь, что в Windows включён компонент «Платформа виртуальной машины».
Если команда wsl --set-default-version 2 выдаёт сообщение об отсутствии ядра, значит, не установлен пакет обновления ядра WSL 2 — скачайте и установите его с официального сайта Microsoft. Иногда после обновления Windows помогает повторная установка этого пакета.
⚠️ Внимание: сторонние гипервизоры и некоторые антивирусы с функциями аппаратной виртуализации могут конфликтовать с WSL 2. Если дистрибутив не стартует при корректных настройках, временно отключите такие компоненты и проверьте результат.
- 🔧 Ошибка 0x80370102 — обычно указывает на отключённую виртуализацию в BIOS
- 🧩 «wsl не распознана» — устаревшая сборка Windows 10, требуется обновление
- 📦 Дистрибутив не запускается — проверьте установку пакета ядра WSL 2
- 🔄 Проблемы после обновления Windows — переустановите пакет ядра и перезагрузитесь
Обновление и удаление WSL
Ядро WSL 2 обновляется командой wsl --update в PowerShell с правами администратора. Проверить состояние и версию можно командой wsl --status. Регулярное обновление ядра закрывает уязвимости и улучшает совместимость, поэтому выполняйте его периодически.
Чтобы удалить ненужный дистрибутив, сначала посмотрите его точное имя через wsl -l -v, затем выполните wsl --unregister ИмяДистрибутива. Учтите: это действие безвозвратно удалит все файлы внутри Linux-окружения. Саму подсистему можно отключить через «Компоненты Windows», сняв галочки с соответствующих пунктов и перезагрузив ПК.
⚠️ Внимание: перед удалением дистрибутива сохраните важные данные, например скопировав их в папку Windows через путь /mnt/c/ внутри терминала Linux. Восстановить удалённое окружение штатными средствами нельзя.
Часто задаваемые вопросы
Работает ли WSL 2 на Windows 10 Home?
Да, WSL 2 доступен в домашней редакции Windows 10 при условии, что установлена версия 2004 или новее и включена виртуализация. Полноценный Hyper-V в Home недоступен, но для WSL 2 он и не требуется — достаточно компонента «Платформа виртуальной машины».
Можно ли установить несколько дистрибутивов одновременно?
Да, ограничений нет. Установите из Microsoft Store столько дистрибутивов, сколько нужно, — каждый работает изолированно. Переключаться между ними можно командой wsl -d ИмяДистрибутива или через меню Windows Terminal.
Как получить доступ к файлам Windows из WSL 2?
Диски Windows автоматически монтируются в каталог /mnt/: диск C доступен как /mnt/c, диск D — как /mnt/d и так далее. Обратный доступ из Windows к файлам Linux открывается через путь \\wsl$ в Проводнике.
Можно ли перенести WSL 2 на другой диск?
Штатной кнопки переноса нет, но существует обходной путь: экспортируйте дистрибутив командой wsl --export в tar-архив, удалите его через wsl --unregister и импортируйте на нужный диск командой wsl --import с указанием новой папки. Перед операцией сделайте резервную копию важных данных.
Нужен ли интернет для установки WSL 2?
Да, на этапе установки интернет обязателен: системе нужно скачать пакет ядра и сам дистрибутив из Microsoft Store. После установки дистрибутив работает и в офлайн-режиме, хотя для обновления пакетов Linux подключение снова понадобится.