Как изменить папку установки новых дистрибутивов WSL

Что именно меняет distributionInstallPath

Microsoft описывает `distributionInstallPath` как глобальный параметр WSL с абсолютным Windows-путём к каталогу по умолчанию для новых дистрибутивов. По умолчанию используется `%LocalAppData%\wsl`. Параметр находится в `[general]`, а не в `[wsl2]`, поэтому не смешивайте его с настройками памяти, swap или ядра. Изменение полезно, когда новые Linux-окружения нужно сразу размещать на другом локальном диске, не перемещая каждое после установки.

Совет: Выберите локальный каталог, который доступен вашей учётной записи Windows и не зависит от временно отключаемого сетевого диска.

Как задать новый каталог для будущих установок

1. Откройте `%UserProfile%` в Проводнике или PowerShell и найдите файл `.wslconfig`; если его нет, создайте обычный текстовый файл именно с этим именем без расширения `.txt`.
2. Если секция `[general]` уже существует, не создавайте вторую. Добавьте в неё строку `distributionInstallPath=D:\WSL`, заменив путь на свой абсолютный Windows-каталог.
3. Сохраните файл и закройте рабочие процессы внутри WSL. Выполните `wsl --shutdown` из PowerShell, чтобы конфигурация была перечитана при следующем запуске.
4. Установите новый тестовый дистрибутив обычной командой `wsl --install -d <Имя>` или другим штатным способом установки.
5. Проверьте, что новый дистрибутив появился в `wsl -l -v`, а его данные создаются в заданном каталоге. Старые дистрибутивы должны остаться на прежних местах.

Предупреждение: `wsl --shutdown` остановит все запущенные WSL-дистрибутивы. Перед командой завершите рабочие процессы и сохраните файлы.

Что проверить, если путь не применяется

• Файл расположен именно как `%UserProfile%\.wslconfig`, а не внутри Linux в `/etc`.
• Ключ записан в единственной секции `[general]` без опечатки в `distributionInstallPath`.
• Указан абсолютный Windows-путь и каталог доступен текущему пользователю.
• После правки WSL был полностью остановлен, а проверка выполнялась на новом дистрибутиве.

Важно: Не удаляйте папку старого дистрибутива после смены параметра: эта настройка не является командой миграции существующей установки.

Почему старые дистрибутивы не переезжают

`distributionInstallPath` задаёт место по умолчанию на этапе новой установки. Уже зарегистрированный дистрибутив имеет собственное текущее расположение, поэтому правка `.wslconfig` не должна рассматриваться как перенос VHDX. Если цель — освободить системный диск, используйте отдельный поддерживаемый сценарий перемещения или export/import для конкретного дистрибутива, предварительно сохранив важные данные. Не копируйте рабочий VHDX вручную между папками в надежде, что WSL автоматически найдёт его по новому глобальному пути.

Как проверить результат без риска для рабочего Linux

Лучше проверять настройку на небольшом новом дистрибутиве, а не на единственной рабочей среде. Сначала выполните `wsl -l -v`, чтобы зафиксировать текущий список, затем установите тестовый дистрибутив после `wsl --shutdown`. Если он создаётся в новом каталоге, параметр применяется; после проверки тестовую установку можно штатно удалить командой `wsl --unregister <Имя>`, убедившись, что выбрано именно тестовое окружение. Если путь игнорируется, вернитесь к расположению файла, секции и синтаксису вместо ручного переноса данных.

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

`distributionInstallPath` задаёт место по умолчанию на этапе новой установки. Уже зарегистрированный дистрибутив имеет собственное текущее расположение, поэтому правка `.wslconfig` не должна рассматриваться как перенос VHDX. Если цель — освободить системный диск, используйте отдельный поддерживаемый сценарий перемещения или export/import для конкретного дистрибутива, предварительно сохранив важные данные. Не копируйте рабочий VHDX вручную между папками в надежде, что WSL автоматически найдёт…

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

Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-22.

• Advanced settings configuration in WSL