Установка WSL с Ubuntu для разработки на Windows 10/11

Введение / Зачем это нужно

WSL (Windows Subsystem for Linux) — это встроенная в Windows технология, позволяющая запускать полноценную среду Linux без виртуальной машины или двойной загрузки. В этом гайде вы установите Ubuntu на WSL 2 — современную версию с полной совместимостью с Linux-приложениями, включая systemd, Docker и графические интерфейсы.

После выполнения инструкции вы получите:

• Рабочее окружение Ubuntu (LTS-версия)
• Поддержку всех стандартных Linux-инструментов (git, gcc, npm, python, docker)
• Прямой доступ к файловой системе Windows через /mnt/c
• Гибкость: можно переключаться между Windows и Linux-командами в одном терминале

💡 Совет: WSL 2 работает быстрее и надёжнее WSL 1 для большинства задач разработки. Убедитесь, что ваша система поддерживает WSL 2 (сборка Windows ≥ 19041).

Требования / Подготовка

Перед началом проверьте:

• Версия Windows:
  • Windows 10: версия 2004 или выше (сборка 19041+)
  • Windows 11: любая сборка
    Проверьте: winver → «Сборка ОС».
• Включённая виртуализация в BIOS/UEFI:
  Для WSL 2 требуется аппаратная поддержка виртуализации (Intel VT-x / AMD-V). Проверьте в Диспетчере задач → вкладка «Производительность» → «Виртуализация»: статус должен быть «Включена».
• Права администратора:
  Учётная запись должна иметь права администратора — установка WSL требует изменений на уровне ядра.

⚠️ Важно: Если виртуализация отключена, WSL 2 не запустится — система автоматически переключится на WSL 1, что может вызвать проблемы совместимости.

Шаг 1: Включить WSL и установить ядро

Откройте PowerShell от имени администратора и выполните:

wsl --install

Эта команда:

• Включает подсистему WSL (Microsoft-Windows-Subsystem-Linux)
• Устанавливает последнюю версию ядра WSL (x64)
• Загружает и устанавливает Ubuntu по умолчанию

Если команда wsl --install недоступна (ошибка «не является внутренней командой»), выполните вручную:

# Включить WSL и WSL2
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# Перезагрузите компьютер
shutdown /r /t 5

💡 Совет: После перезагрузки скачайте и установите ядро WSL 2 вручную: https://aka.ms/wsl2kernel (x64, .msi).

Шаг 2: Установить Ubuntu в WSL

После перезагрузки и установки ядра снова откройте PowerShell и выполните:

wsl --install -d Ubuntu

Это установит Ubuntu 22.04 LTS (или актуальную LTS-версию на момент установки). Если нужна Ubuntu 24.04:

wsl --install -d Ubuntu-24.04

💡 Совет: Список доступных дистрибутивов — wsl --list --online. Для установки конкретной версии: wsl --install -d Ubuntu-22.04.

После завершения установки запустите Ubuntu из меню «Пуск» или выполните:

wsl

При первом запуске система попросит задать:

• Имя пользователя (например, user)
• Пароль (введите и подтвердите)

⚠️ Важно: Пароль вводится без отображения — даже звёздочки не появятся. Просто введите и нажмите Enter.

Шаг 3: Убедиться, что используется WSL 2

Проверьте текущую версию:

wsl --list --verbose

Если в колонке VERSION стоит 1, обновите Ubuntu до WSL 2:

wsl --set-version Ubuntu 2

💡 Совет: По умолчанию установка через wsl --install использует WSL 2, но если вы вручную устанавливали через Microsoft Store — иногда остаётся WSL 1.

Чтобы сделать WSL 2 версией по умолчанию для новых дистрибутивов:

wsl --set-default-version 2

Шаг 4: Обновить ядро WSL и дистрибутив Ubuntu

Обновите ядро и пакеты Ubuntu:

# Внутри Ubuntu (выполните после запуска `wsl`)
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential curl git vim

💡 Совет: Регулярно обновляйте ядро WSL через PowerShell: wsl --update.

Проверка результата

Убедитесь, что всё работает корректно:

1. Версия ядра Linux:

   uname -r
   # Должно быть что-то вроде: 5.15.133.1-WSL2
   

2. Доступ к Windows-файлам:

   ls /mnt/c
   # Должны отображаться папки Windows (Program Files, Users и т.д.)
   

3. Тест компиляции:

   echo 'int main(){return 0;}' > test.c && gcc test.c -o test && ./test && echo "OK"
   

Если все команды завершились без ошибок — среда готова к разработке.

Возможные проблемы

Ошибка 0x800701bc при установке WSL

• Причина: Повреждённый компонент WSL или отсутствует обновление платформы.
• Решение:
  1. Выполните sfc /scannow в PowerShell от администратора.
  2. Повторно установите ядро WSL 2 вручную.
  3. Убедитесь, что установлены все обновления Windows.

Ubuntu зависает при запуске

• Причина: Повреждённый пакет systemd (в WSL 2 редко, но бывает).
• Решение:

  wsl --terminate Ubuntu
  wsl --shutdown
  wsl
  

Медленная работа в Ubuntu

• Причина: Файловая система Ubuntu ( /home/user) находится на сетевом драйве или медленном диске.
• Решение:
  • Перенесите проекты в Linux-файловую систему (/home/...), а не в /mnt/c/...
  • Отключите в реестре NtfsDisable8dot3NameCreation=0 (только для опытных пользователей).

💡 Совет: Для ускорения доступа к файлам Windows из Ubuntu используйте wslpath:
code "$(wslpath -w 'c:\Projects\myapp')" — откроет папку в VS Code напрямую.