Настройка среды разработки на Windows 11 и 10: полное руководство

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

Настройка рабочего пространства для разработки на Windows — задача, которую приходится решать практически каждому программисту. Правильно configured среда экономит часы времени в будущем, избавляя от проблем с зависимостями, путями и конфигурациями. После выполнения этого гайда у вас будет полноценная, современная среда, сравнимая с macOS или Linux, для работы над проектами на Python, JavaScript/Node.js, .NET, Go, Rust и многих других языках. Вы сможете запускать контейнеры Docker, использовать Linux-инструменты через WSL2 и коммитить код в Git.

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

Перед началом убедитесь, что:

1. У вас есть Windows 10 (версия 2004, сборка 19041 или выше) или Windows 11.
2. Права администратора на компьютере (требуются для установки компонентов и ПО).
3. Не менее 10 ГБ свободного места на системном диске (рекомендуется 20+ ГБ).
4. Подключение к интернету для скачивания установщиков и компонентов.
5. Включена виртуализация в BIOS/UEFI (Intel VT-x / AMD-V). Обычно включается в настройках безопасности/процессора материнской платы.

Пошаговая инструкция

Шаг 1: Включение виртуализации и компонентов Windows

WSL2 и Hyper-V требуют поддержки виртуализации на уровне процессора и включения соответствующих компонентов ОС.

1. Проверьте, включена ли виртуализация: Откройте Диспетчер задач → вкладка Производительность → CPU. В правом нижнем углу ищите строку "Виртуализация: включено". Если "отключено", перезагрузите компьютер, зайдите в BIOS/UEFi и найдите опцию Intel Virtualization Technology (VT-x) или SVM Mode (AMD-V) и включите её.
2. Включите компоненты Windows через PowerShell (администратор):

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

   
   Эти команды активируют подсистему Linux и платформу виртуализации.
3. Перезагрузите компьютер. Это обязательный шаг для применения изменений.

Шаг 2: Установка WSL2 и дистрибутива Linux

1. Установите WSL2 как версию по умолчанию: В PowerShell (администратор) выполните:

   wsl --set-default-version 2
   

2. Установите дистрибутив Linux (Ubuntu):
   • Откройте Microsoft Store.
   • Найдите "Ubuntu" (рекомендуется LTS-версия, например, Ubuntu 22.04 LTS).
   • Нажмите "Установить".
   • После установки нажмите "Запустить".
   • При первом запуске потребуется создать учётную запись пользователя (не root) и задать пароль. Запомните пароль.
3. Обновите пакеты Ubuntu: Откройте Ubuntu (через меню "Пуск" или поиск) и выполните:

   sudo apt update && sudo apt upgrade -y
   

Шаг 3: Установка Git для Windows

Git — система контроля версий, обязательная для любого разработчика.

1. Скачайте установщик с официального сайта.
2. Запустите установщик. На этапе "Select Components" рекомендуется оставить галочки:
   • Git Bash Here (консоль с Git-командами).
   • Git GUI Here (графический клиент).
   • Git LFS (Large File Support).
   • *Associate .git configuration files...**.
3. На этапе "Choosing the default editor used by Git" выберите ваш основной редактор (VS Code, Notepad++ или оставьте Vim).
4. На этапе "Adjusting your PATH environment" выберите "Git from the command line and also from 3rd-party software" (рекомендуется). Это позволит вызывать git из любой консоли (PowerShell, CMD, WSL).
5. Завершите установку.

Проверка: Откройте PowerShell или Git Bash и выполните git --version. Должна отобразиться версия (например, git version 2.45.0.windows.1).

Шаг 4: Установка Docker Desktop

Docker Desktop предоставляет удобный GUI для работы с контейнерами и интегрируется с WSL2.

1. Скачайте установщик Docker Desktop для Windows с официального сайта.
2. Запустите установщик. Следуйте инструкциям, оставляя настройки по умолчанию.
3. Критически важный шаг: В процессе установки система предложит включить интеграцию с WSL2. Обязательно отметьте галочкой вашу установленную Ubuntu (например, Ubuntu-22.04). Это позволит Docker работать поверх WSL2.
4. После установки перезагрузите компьютер.
5. Запустите Docker Desktop из меню "Пуск". При первом запуске он завершит настройку и запросит права WSL. Согласитесь.
6. Дождитесь, пока в системном трее (рядом с часами) иконка Docker станет белой (работает).

Проверка: Откройте PowerShell или WSL (Ubuntu) и выполните docker --version и docker run hello-world. Если команда с hello-world завершилась успешно, Docker работает.

Шаг 5: Установка языков программирования и пакетных менеджеров

Установите необходимые вам рантаймы. Рекомендуется устанавливать как в Windows (для нативных .exe), так и в WSL (Ubuntu) для совместимости.

Python

• Для Windows: Скачайте установщик с python.org. Обязательно на первом экране установки отметьте галочку "Add python.exe to PATH".
• Для WSL (Ubuntu): В терминале Ubuntu выполните sudo apt install python3 python3-pip python3-venv -y.
• Проверка: python --version (Windows) или python3 --version (WSL).

Node.js (npm)

• Для Windows: Скачайте LTS-версию установщика с nodejs.org. Установщик сам добавит node и npm в PATH.
• Для WSL (Ubuntu): Лучше использовать nvm для управления версиями:

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc
  nvm install --lts
  

• Проверка: node --version, npm --version.

Go, Rust, Java и др.

Устанавливайте с официальных сайтов, следуя инструкциям для Windows. Для инструментов, активно используемых в терминале (Go, Rust), также установите их в WSL для лучшей производительности.

Шаг 6: Установка и базовая настройка IDE

Visual Studio Code (рекомендуется для большинства)

1. Скачайте установщик с code.visualstudio.com.
2. Установите, отметьте все предлагаемые опции (добавление в PATH, ассоциация файлов).
3. После запуска установите ключевые расширения:
   • Python (Microsoft)
   • Docker (Microsoft)
   • ESLint (для JavaScript/TypeScript)
   • Remote - WSL (Microsoft) — обязательно! Позволяет открывать папки из WSL прямо в VS Code с правильными путями и интерпретаторами.
   • GitLens (для работы с Git)
4. Настройте settings.json (Ctrl+Shift+P → "Preferences: Open Settings (JSON)") для удобства:

   {
       "terminal.integrated.defaultProfile.windows": "Git Bash",
       "editor.tabSize": 4,
       "files.autoSave": "afterDelay"
   }
   

Visual Studio Community 2022 (для .NET/C++)

1. Скачайте с visualstudio.microsoft.com.
2. Запустите установщик Visual Studio Installer.
3. Выберите рабочую нагрузку (Workloads):
   • .NET desktop development (для C#, F#, VB.NET).
   • Desktop development with C++ (если нужно).
   • Python development (если работаете с Python в VS).
   • Node.js development (если работаете с Node.js в VS).
4. На вкладке "Индивидуальные компоненты" можно добавить Git для Windows, если не установлен.
5. Начните установку (занимает 30-60 минут и много места).

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

1. WSL: Откройте Ubuntu из меню "Пуск". Выполните lsb_release -a. Должна отобразиться информация об Ubuntu.
2. Git: В PowerShell git --version.
3. Docker: В PowerShell docker ps (должен показать пустой список контейнеров без ошибок).
4. Языки: Проверьте версии установленных Python, Node.js и других.
5. IDE: Запустите VS Code, убедитесь, что расширения активны. Попробуйте открыть папку из WSL: в VS Code (F1) → WSL: New Window. В открывшемся окне WSL откройте папку /home/<ваш_пользователь>/projects.

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

Ошибка: "WSL 2 требует обновления ядра"

Причина: Устаревшая версия ядра Linux для WSL2. Решение: Скачайте и установите последнюю версию WSL2 Linux kernel update package с официальной страницы Microsoft.

Ошибка: "Docker Desktop requires a newer WSL kernel version"

Причина: То же, что и выше. Docker Desktop проверяет версию ядра. Решение: Установите обновление ядра, как описано выше, затем перезапустите Docker Desktop.

Ошибка: "Cannot connect to the Docker daemon at unix:///var/run/docker.sock"

Причина: Docker-демон не запущен в WSL2 или у пользователя нет прав. Решение:

1. Убедитесь, что Docker Desktop запущен (иконка в трее).
2. В WSL (Ubuntu) выполните sudo service docker start.
3. Для избежания постоянного sudo добавьте текущего пользователя в группу docker: sudo usermod -aG docker $USER. Выйдите из терминала и зайдите заново.

Ошибка: "The command 'git' could not be found"

Причина: Git не установлен или путь к нему не добавлен в переменную окружения PATH. Решение: Переустановите Git for Windows, на этапе "Adjusting your PATH" выбрав вариант "Git from the command line and also from 3rd-party software". Перезапустите терминал (PowerShell/WSL).

Медленная работа файловой системы WSL2

Причина: Доступ к файлам, расположенным в Windows-разделе (/mnt/c/...), из WSL2 медленный из-за моста между системами. Решение: Храните проекты внутри файловой системы WSL2, т.е. в домашней директории Ubuntu (~/projects), а не на Windows-диске. Для доступа к ним из Windows используете \\wsl$\Ubuntu\home\<user>\projects в проводнике. Для работы в VS Code используйте расширение Remote - WSL.