Введение / Зачем это нужно
WSL2 (Windows Subsystem for Linux 2) — это революционная технология, которая позволяет запускать полноценный Linux-ядро напрямую в Windows 11 без виртуальной машины среднего уровня. Это открывает доступ к мощному экосистеме инструментов разработки (Docker, Git, Python, Node.js), системного администрирования и data science прямо на вашем рабочем столе Windows. После выполнения этого гайда вы сможете работать с Linux-окружением нативно, запускать bash-скрипты, использовать systemd и даже запускать графические Linux-приложения (WSLg), которые будут отображаться как обычные окна Windows.
Требования / Подготовка
Перед началом убедитесь, что ваша система соответствует требованиям:
- Операционная система: Windows 11 версии 22H2 (сборка 22621) или новее. Проверить версию можно в
Параметры→Система→О системе. - Аппаратная виртуализация: Процессор должен поддерживать виртуализацию (Intel VT-x или AMD-V), и эта опция должна быть включена в BIOS/UEFI. Как правило, это включено по умолчанию, но на ноутбуках или ПК от производителя (особенно корпоративных) может быть отключено.
- Права администратора: Вам потребуются права локального администратора для включения компонентов Windows и установки программ.
- Подключение к интернету: Требуется для скачивания компонентов Windows и ядра Linux.
⚠️ Важно: Если у вас Windows 11 Pro, Education или Enterprise, вы можете использовать Hyper-V. Для WSL2 это необязательно, но если Hyper-V отключен globally, его включение через этот гайд также активирует необходимые компоненты виртуализации.
Пошаговая инструкция
Шаг 1: Включение компонентов Windows через PowerShell
Откройте PowerShell или Терминал Windows от имени администратора (щёлкните правой кнопкой мыши → "Запуск от имени администратора").
Выполните команду, которая активирует две ключевые возможности:
Microsoft-Windows-Subsystem-Linux— сама подсистема.VirtualMachinePlatform— платформа виртуальных машин, на которой работает WSL2.
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
💡 Совет: Если команды выполняются долго или зависают, убедитесь, что у вас стабильное интернет-соединение, а антивирус или брандмауэр не блокируют доступ к серверам обновлений Windows.
Шаг 2: Установка ядра WSL2
После перезагрузки компьютера (обязательно!) скачайте и установите пакет обновления ядра Linux для WSL2.
- Перейдите на официальную страницу загрузки: https://aka.ms/wsl2kernel.
- Скачайте файл
wsl_update_x64.msi(для большинства современных процессоров). - Запустите скачанный установщик и следуйте инструкциям. Процесс займет менее минуты.
Альтернативный способ — установка через PowerShell (требует .NET 4.7.2 и выше):
wsl --update
Эта команда автоматически скачает и установит последнюю версию ядра WSL2.
Шаг 3: Установка дистрибутива Linux (Ubuntu в примере)
Самый простой способ — использовать Microsoft Store.
- Откройте Microsoft Store.
- В поиске введите
Ubuntu. ВыберитеUbuntu 22.04 LTSилиUbuntu 24.04 LTS(рекомендуется LTS-версия для стабильности). - Нажмите
Установить.
Или через командную строку (PowerShell):
wsl --install -d Ubuntu
Эта команда установит Ubuntu по умолчанию. Чтобы увидеть список всех доступных дистрибутивов, выполните:
wsl --list --online
Шаг 4: Первый запуск и настройка
После установки найдите Ubuntu в меню "Пуск" и запустите. Откроется окно консоли.
- Подождите 1-2 минуты, пока завершится первоначальная unpacking и настройка.
- Вас попросят создать пользователя (имя пользователя) и пароль для этого Linux-окружения. Они не связаны с вашими учётными данными Windows.
- После входа вы окажетесь в привычном bash-приглашении
user@machine:~$.
Шаг 5: Проверка версии и переход на WSL2 (если нужно)
По умолчанию новая установка через wsl --install использует WSL2. Но если вы ранее работали с WSL1, нужно явно указать версию.
- Убедитесь, что WSL2 установлена как версия по умолчанию:
wsl --set-default-version 2 - Проверьте список установленных дистрибутивов и их версий:
В колонкеwsl --list --verboseVERSIONу вашего Ubuntu должно быть2.
Проверка результата
- Запустите Ubuntu из меню "Пуск" или выполните в PowerShell/Cmd
wsl. - Внутри Linux-консоли выполните команду для проверки версии ядра:
Вывод должен содержатьuname -rmicrosoft-standardи выглядеть примерно так:5.15.90.1-microsoft-standard-WSL2. - (Для Windows 11 22H2+) Протестируйте запуск GUI-приложения. В той же консоли Ubuntu выполните:
Должно открыться окно текстового редактораsudo apt update && sudo apt install -y gedit geditgeditна рабочем столе Windows.
Возможные проблемы
Ошибка 0x80370114 / "Не удалось включить виртуальную машину"
Причина: Виртуализация отключена в BIOS/UEFI или конфликтует с другими гипервизорами (например, Hyper-V на Windows 10 Pro, который не полностью отключён). Решение:
- Перезагрузите компьютер, зайдите в BIOS/UEFI (обычно клавиша Del/F2/F12 при старте) и найдите опцию
Intel VT-x,AMD-V,SVM ModeилиVirtualization Technology. Включите её.- В Windows отключите Hyper-V, если он не используется:
dism.exe /online /disable-feature /featurename:Microsoft-Hyper-V-All.
Ошибка "WSL 2 требует обновления своей компоненты"
Причина: Ядро WSL2 устарело. Решение: Выполните в PowerShell (от администратора)
wsl --updateи перезапустите WSL (wsl --shutdown).
Нет доступа к файловой системе Windows (/mnt/c)
Причина: Служба WSL не запущена или возникла ошибка монтирования. Решение: Перезапустите службу:
wsl --shutdownв PowerShell, затем снова запустите дистрибутив. Если не помогает, проверьте целостность системных файлов:sfc /scannowв командной строке от администратора.
Медленная работа или высокое потребление памяти
Причина: В WSL2 по умолчанию выделяется 50% оперативной памяти и может использоваться swap-файл. Решение: Создайте файл
.wslconfigв папкеC:\Users\<Ваше_Имя>\с ограничениями:[wsl2] memory=4GB processors=2Перезапустите WSL:
wsl --shutdown. Настройки вступят в силу при следующем запуске дистрибутива.
Не работает GUI (WSLg) на Windows 11 Home
Причина: Устаревшая сборка Windows 11 Home (до 22H2) или отсутствуют обновления. Решение: Убедитесь, что установлена Windows 11 22H2 (сборка 22621) или новее. Обновите систему через
Параметры→Центр обновления Windows. WSLg требует сборки 22621.0 или выше. Проверьте версию командойverв Cmd.
Ошибка "Вы не имеете достаточных прав" при установке дистрибутива
Причина: PowerShell или Терминал не запущены от имени администратора. Решение: Закройте текущее окно, откройте PowerShell/Терминал щёлчком правой кнопки мыши → "Запуск от имени администратора" и повторите установку.