Команда wsl --install в Windows 10 не работает в старых сборках системы — она появилась только в версии 2004 (сборка 19041) и выше, поэтому на более ранних редакциях подсистему придётся включать вручную через компоненты Windows. Подсистема Windows для Linux (WSL) позволяет запускать Linux-окружение прямо внутри Windows 10 без виртуальной машины и двойной загрузки, что удобно для разработчиков, администраторов и всех, кто работает с консольными инструментами Linux.
В этом руководстве разберём проверку совместимости системы, два способа установки, переход на WSL 2, типичные ошибки вроде 0x8007019e и базовую настройку дистрибутива после первого запуска.
Проверка совместимости Windows 10 с WSL
Перед установкой убедитесь, что система соответствует минимальным требованиям. Для WSL 1 нужна 64-битная Windows 10, а для WSL 2 — версия 2004 (сборка 19041) или новее. Проверить номер сборки можно командой winver, запущенной через диалог «Выполнить» (Win+R).
Для WSL 2 дополнительно требуется включённая виртуализация в BIOS/UEFI (технологии Intel VT-x или AMD-V). Проверить её состояние можно в Диспетчере задач: вкладка «Производительность» → раздел «ЦП» → строка «Виртуализация». Если там указано «Отключено», потребуется зайти в настройки BIOS и активировать соответствующий параметр — его название и расположение зависят от производителя материнской платы.
- 🖥️ Откройте
winverи запишите версию и номер сборки Windows 10. - ⚙️ Проверьте виртуализацию в Диспетчере задач (Ctrl+Shift+Esc).
- 📦 Убедитесь, что на диске C есть свободное место под дистрибутив и обновления.
- 🔑 Подготовьте учётную запись с правами администратора — без них компоненты не включить.
Установка WSL через одну команду
Если у вас Windows 10 версии 2004 и новее с актуальными обновлениями, самый простой путь — команда wsl --install. Откройте PowerShell от имени администратора и выполните:
wsl --installКоманда автоматически включает нужные компоненты («Подсистема Windows для Linux» и «Платформа виртуальной машины»), скачивает ядро WSL 2, устанавливает его по умолчанию и ставит дистрибутив Ubuntu. После завершения обязательно перезагрузите компьютер — без перезагрузки изменения не вступят в силу.
Если нужен другой дистрибутив, сначала посмотрите доступные варианты командой wsl --list --online, а затем укажите нужный: wsl --install -d Debian. Список доступных дистрибутивов зависит от региона и актуального состояния Microsoft Store.
Ручная установка через компоненты Windows
На старых сборках Windows 10 или когда автоматическая команда недоступна, компоненты включаются вручную. В PowerShell с правами администратора выполните последовательно две команды:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Первая команда активирует саму подсистему, вторая — платформу виртуальной машины, необходимую для WSL 2. После обеих команд перезагрузите ПК. Затем скачайте и установите пакет обновления ядра WSL 2 с официального сайта Microsoft и назначьте WSL 2 версией по умолчанию:
wsl --set-default-version 2Финальный шаг — установить дистрибутив из Microsoft Store (например, Ubuntu, Debian или Kali Linux) и запустить его из меню «Пуск». При первом запуске система предложит создать имя пользователя и пароль для Linux-окружения — они не связаны с вашей учётной записью Windows.
☑️ Порядок ручной установки WSL
⚠️ Внимание: не пропускайте перезагрузку между включением компонентов и установкой дистрибутива. Запуск Linux-системы до перезагрузки приводит к ошибке 0x8007019e — «WSL не включён».
Различия WSL 1 и WSL 2
Две версии подсистемы устроены принципиально по-разному. WSL 1 транслирует системные вызовы Linux в вызовы ядра Windows, а WSL 2 использует настоящее ядро Linux, работающее в лёгкой виртуальной машине. Отсюда различия в производительности и совместимости.
| Критерий | WSL 1 | WSL 2 |
|---|---|---|
| Ядро Linux | Нет (эмуляция вызовов) | Полноценное ядро |
| Скорость работы с файлами Linux | Ниже | Заметно выше |
| Доступ к файлам Windows | Быстрее | Медленнее при кросс-доступе |
| Поддержка Docker и systemd | Ограниченная | Полная (Docker) / systemd в новых версиях |
| Требования | Любая 64-битная Windows 10 | Версия 2004+, виртуализация |
Переключить уже установленный дистрибутив между версиями можно командой wsl --set-version <имя_дистрибутива> 2. Узнать текущую версию каждого дистрибутива поможет wsl -l -v.
Типичные ошибки и их решение
Самая частая проблема — ошибка 0x8007019e при запуске дистрибутива. Она означает, что компонент WSL не включён или система не была перезагружена после его активации. Решение: включить компонент через dism или «Компоненты Windows» и перезагрузить ПК.
Ошибка 0x80370102 при запуске WSL 2 указывает на отключённую виртуализацию. Проверьте Диспетчер задач, а при необходимости зайдите в BIOS/UEFI и активируйте Intel VT-x или AMD-V. Точное расположение настройки зависит от производителя платы — сверьтесь с документацией к вашей модели.
- 🚫
0x8007019e— компонент WSL отключён, включите его и перезагрузитесь. - 💻
0x80370102— виртуализация выключена в BIOS/UEFI. - 🔄 Дистрибутив не ставится из Store — проверьте, не заблокирован ли Microsoft Store политиками (актуально для корпоративных ПК).
- 🐢 Медленная работа — проверьте, не обращаетесь ли вы к файлам Windows через
/mnt/cиз WSL 2: это заметно медленнее, чем работа внутри файловой системы Linux.
⚠️ Внимание: на корпоративных компьютерах установка WSL может быть запрещена групповыми политиками. Если команды завершаются ошибками доступа, обратитесь к системному администратору, а не пытайтесь обходить ограничения.
Как полностью удалить дистрибутив WSL
Выполните wsl --unregister <имя_дистрибутива> в PowerShell. Это удалит дистрибутив вместе со всеми его файлами и настройками. Само приложение дистрибутива затем можно удалить через «Параметры» → «Приложения». Действие необратимо — данные внутри Linux-окружения будут потеряны.
Настройка дистрибутива после установки
После первого запуска и создания пользователя стоит сразу обновить пакеты системы. В Ubuntu и Debian это делается стандартной командой:
sudo apt update && sudo apt upgrade -yДалее можно настроить потребление ресурсов. WSL 2 по умолчанию может занимать значительную часть оперативной памяти. Ограничения задаются через файл .wslconfig в папке пользователя Windows (C:\Users\Имя\.wslconfig), где указываются лимиты памяти и числа процессорных ядер. После изменения файла выполните wsl --shutdown и запустите дистрибутив заново.
Файлы Windows доступны из Linux по пути /mnt/c, а файлы Linux из Windows — через сетевой путь \\wsl$\ИмяДистрибутива в Проводнике. Для интенсивной работы с проектом держите его файлы внутри файловой системы Linux — так производительность будет максимальной.
Интеграция с инструментами разработки
Главная ценность WSL раскрывается в связке с редактором кода. Visual Studio Code с расширением Remote — WSL позволяет открывать проекты прямо внутри Linux-окружения: терминал, отладчик и все расширения работают в контексте Linux, а интерфейс остаётся в Windows.
Для контейнеризации Docker Desktop умеет использовать WSL 2 в качестве бэкенда — это официально рекомендуемый режим работы Docker в Windows. Также доступен Windows Terminal — современный терминал с вкладками, где можно держать рядом PowerShell, CMD и любой установленный дистрибутив Linux.
Часто задаваемые вопросы
Работает ли WSL в Windows 10 Home?
Да. Подсистема Windows для Linux доступна во всех редакциях Windows 10, включая Home. Для WSL 2 используется платформа виртуальной машины, которая не требует полноценного Hyper-V, недоступного в домашней редакции.
Можно ли установить несколько дистрибутивов одновременно?
Да, ограничений нет. Можно поставить Ubuntu, Debian и другие дистрибутивы параллельно и переключаться между ними. Дистрибутив по умолчанию задаётся командой wsl --set-default <имя>.
Почему WSL 2 медленно работает с файлами на диске C?
Это известная особенность архитектуры: обращение из WSL 2 к файловой системе Windows через /mnt/c идёт через сетевой протокол и заметно медленнее, чем работа с родной файловой системой Linux. Храните рабочие проекты внутри домашней папки Linux, например ~/projects.
Как обновить ядро WSL 2?
Выполните в PowerShell команду wsl --update. На системах, где эта команда недоступна, ядро обновляется установкой актуального пакета с официального сайта Microsoft.
Занимает ли WSL много места на диске?
Сама подсистема занимает немного, но дистрибутивы растут по мере установки пакетов — виртуальный диск WSL 2 расширяется автоматически. Контролировать занятое место можно через свойства файла виртуального диска дистрибутива, а неиспользуемые дистрибутивы лучше удалять через wsl --unregister.