Текст и данные · Инструкция
Как открыть проект WSL в VS Code командой code .
Как открыть проект WSL в VS Code командой code . — установите VS Code в Windows, добавьте расширение WSL и запускайте команду из каталога проекта внутри Linux.
Короткий ответ
Установите VS Code в Windows и расширение WSL, затем из терминала нужного дистрибутива перейдите в каталог проекта и выполните `code .`. В левом нижнем углу VS Code должна появиться индикация WSL-сессии, а сервер редактора запустится внутри Linux-окружения.
Как работает связка VS Code + WSL
Расширение WSL разделяет клиент и рабочее окружение: интерфейс VS Code работает в Windows, а серверная часть выполняется в выбранном дистрибутиве WSL. Команда `code .`, запущенная внутри Linux-терминала, передаёт текущую папку в этот режим. Если запускать проект через обычное `File > Open Folder` по Windows-пути, расширения и терминал могут оказаться не там, где вы ожидаете.
Совет: Открывайте `code .` именно из каталога проекта в WSL — так меньше шансов случайно подключиться к другому дистрибутиву.
Открытие проекта из Linux-терминала
- Установите Windows-версию VS Code и официальное расширение WSL из набора Remote Development.
- Откройте терминал нужного дистрибутива и командой `cd` перейдите в каталог проекта, желательно расположенный в Linux-файловой системе.
- Выполните `code .` и дождитесь первого запуска сервера VS Code внутри WSL; он может занять больше времени, чем последующие.
- Проверьте индикатор удалённой среды внизу окна и откройте встроенный терминал: приглашение должно быть Linux, а не PowerShell.
- Запустите команду проекта — например, `node --version` или `python --version` — и убедитесь, что используется Linux-инструментарий.
Предупреждение: Не редактируйте Linux-системные файлы через непредусмотренный прямой доступ к файлам виртуального диска WSL.
Признаки правильной WSL-сессии
- Окно VS Code явно отмечено как подключённое к WSL.
- Встроенный терминал показывает Linux-путь проекта.
- Расширения, требующие выполнения в Linux, видят WSL-окружение.
- Исходники не были случайно скопированы в другое место только ради открытия редактора.
Важно: Критерий результата: Проект открыт в окне VS Code, подключённом к нужному WSL-дистрибутиву, а терминал и инструменты проекта выполняются в Linux.
Где лучше хранить файлы проекта
Для проектов с большим количеством мелких файлов Microsoft рекомендует хранить код в файловой системе WSL, если инструменты запускаются из Linux: доступ к `/mnt/c` может быть медленнее и имеет другие правила разрешений. Если `code` не найден, перезапустите терминал после установки VS Code и проверьте интеграцию расширения WSL, вместо ручного копирования серверных файлов. Команду лучше выполнять из каталога проекта внутри WSL, например после `cd ~/projects/app`; тогда `code .` передаёт VS Code именно Linux-путь. Не открывайте тот же репозиторий одновременно как `C:\..` и как `/mnt/c/..` в двух разных окнах для одной задачи: это усложняет выбор интерпретатора, терминала и путей расширений. Если проект лежит в home WSL, открывайте его только из WSL-контекста.
Как проверить терминал и расширения
В правильно открытом проекте нижний левый индикатор VS Code показывает WSL-контекст, встроенный терминал запускается в Linux, а путь проекта соответствует каталогу дистрибутива. Если редактор открылся как обычное Windows-окно, закройте его и повторите `code .` из нужного WSL-каталога либо используйте команду Reopen Folder in WSL.
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-22; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Get started using VS Code with WSL). Пример и формулировки — редакция N1RO на 2026-09-22.