Что делать, если VS Code Server не запускается в WSL

Почему падает запуск VS Code Server

WSL-расширение разворачивает серверную часть VS Code внутри Linux. Для загрузки компонентов и HTTPS-проверок окружению нужны базовые инструменты. В официальной инструкции Microsoft для Debian и Ubuntu отдельно приведены `wget` и `ca-certificates`. Но это не означает, что любая ошибка Remote WSL лечится их установкой: после базовой проверки нужно смотреть текст журнала и отделять сетевые, дисковые и permission-проблемы.

Совет: Проверяйте `apt-get update` до переустановки пакетов: он быстро показывает, не является ли проблема сетевой.

Проверка пакетов и журнала Remote WSL

1. Откройте обычный терминал проблемного WSL-дистрибутива отдельно от VS Code и убедитесь, что он вообще запускается.
2. Выполните `sudo apt-get update`; если уже здесь ошибка DNS или TLS, сначала устраните сетевую проблему WSL.
3. Установите зависимости командой `sudo apt-get install wget ca-certificates` и дождитесь успешного завершения.
4. Закройте проблемное окно VS Code, снова откройте проект через `code .` и дайте серверу повторно развернуться.
5. Если сбой сохранился, откройте журнал Remote/WSL в VS Code и ищите первую конкретную ошибку, а не последующие каскадные сообщения.

Предупреждение: Не советуем отключать проверку сертификатов ради обхода ошибки TLS — исправляйте доверенную цепочку или прокси.

Что исключить перед переустановкой

• `wget --version` выполняется внутри WSL.
• Пакет `ca-certificates` установлен без ошибок репозитория.
• `sudo apt-get update` проходит без DNS/TLS-сбоев.
• В журнале VS Code после повторного подключения нет прежней ошибки зависимости.

Важно: Критерий результата: VS Code снова подключается к WSL и сервер стартует; если нет, в журнале остаётся конкретная другая причина, по которой можно продолжать диагностику.

Сеть, TLS и корпоративные сертификаты

Не удаляйте папки сервера VS Code вслепую до чтения журнала: это может лишь заставить редактор заново скачать те же файлы. Если `apt-get update` не работает, установка пакетов не решит первопричину. На корпоративной сети дополнительно могут мешать прокси и пользовательские центры сертификации — их нужно настраивать штатно, а не отключать проверку TLS. Сначала воспроизведите ошибку из одного и того же дистрибутива и каталога, затем откройте Remote WSL log и найдите первый реальный сбой установки сервера. Если журнал указывает на отсутствие `wget` или цепочки сертификатов, исправьте пакетный слой внутри этого дистрибутива. Если загрузка проходит, а запуск падает позже, не переустанавливайте `ca-certificates` снова: переходите к указанной filesystem, shell или permission-ошибке.

Как локализовать причину по журналу

После установки недостающих пакетов снова откройте WSL-проект и сразу проверьте журнал Remote WSL. Успех — сервер запускается без повторной загрузочной ошибки и окно получает WSL-контекст. Если сбой остаётся на TLS, proxy или filesystem-этапе, исправляйте именно этот слой; отключать проверку сертификатов ради обхода ошибки не следует.

Что учитывать

WSL-расширение разворачивает серверную часть VS Code внутри Linux. Для загрузки компонентов и HTTPS-проверок окружению нужны базовые инструменты. В официальной инструкции Microsoft для Debian и Ubuntu отдельно приведены `wget` и `ca-certificates`. Но это не означает, что любая ошибка Remote WSL лечится их установкой: после базовой проверки нужно смотреть текст журнала и отделять сетевые, дисковые и permission-проблемы.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Get started using VS Code with WSL). Пример и формулировки — редакция N1RO на 2026-09-22.

• Get started using VS Code with WSL