Текст и данные · Инструкция
Как задать максимальный размер VHD для новых WSL-дистрибутивов
Настройка относится к новым/соответствующим VHD и не является командой мгновенного shrink существующего виртуального дис
Короткий ответ
`defaultVhdSize` задаёт максимальный размер VHD для файловой системы дистрибутива; размер можно указывать с единицами вроде GB. Практический вариант: `В `%UserProfile%\.wslconfig` задайте `[wsl2]` и `defaultVhdSize=256GB`, затем выполните `wsl --shutdown``.
Что делать
- Проверьте исходное состояние: Работайте в нужном репозитории/проекте или контексте инструмента. До изменения зафиксируйте текущее состояние; для последующей проверки используйте `После перезапуска WSL создайте новый дистрибутив и проверьте его VHD; существующие VHD автоматически не уменьшаются.`.
- Выполните основное действие: Запустите `В `%UserProfile%\.wslconfig` задайте `[wsl2]` и `defaultVhdSize=256GB`, затем выполните `wsl --shutdown``. Если команда содержит пример имени, тега, пакета, контейнера или дистрибутива — замените его своим значением.
- Проверьте результат: Выполните `После перезапуска WSL создайте новый дистрибутив и проверьте его VHD; существующие VHD автоматически не уменьшаются.` и сопоставьте вывод с целью страницы: настроить `defaultvhdsize` в `.wslconfig`, чтобы новые wsl 2 vhd получали заданный максимальный размер. Не продолжайте автоматизацию, если проверка показывает другой объект или состояние.
- Зафиксируйте безопасный рабочий вариант: Если действие должно выполняться в CI или скрипте, сначала сохраните проверенную команду в локальном сценарии и добавьте явную обработку ненулевого кода возврата или отсутствующего объекта.
Перед запуском
- Вы находитесь в нужном проекте, репозитории, Docker context или Python/Node окружении.
- Команда проверки известна заранее: `После перезапуска WSL создайте новый дистрибутив и проверьте его VHD; существующие VHD автоматически не уменьшаются.`.
- Имена веток, тегов, пакетов, контейнеров и дистрибутивов заменены на ваши.
- Для необратимых удалённых действий есть резервный путь восстановления или подтверждение в UI/API.
Важно
Не копируйте пример вслепую. Команда `В `%UserProfile%\.wslconfig` задайте `[wsl2]` и `defaultVhdSize=256GB`, затем выполните `wsl --shutdown`` может менять состояние проекта, registry, remote, контейнера или окружения. Перед запуском проверьте имена объектов, права и текущий контекст.
Почему это работает
`defaultVhdSize` задаёт максимальный размер VHD для файловой системы дистрибутива; размер можно указывать с единицами вроде GB.
Проверка
- Основное действие: В `%UserProfile%\.wslconfig` задайте `[wsl2]` и `defaultVhdSize=256GB`, затем выполните `wsl --shutdown`
- Проверка: После перезапуска WSL создайте новый дистрибутив и проверьте его VHD; существующие VHD автоматически не уменьшаются.
Что учитывать
Не копируйте пример вслепую. Команда `В `%UserProfile%\.wslconfig` задайте `[wsl2]` и `defaultVhdSize=256GB`, затем выполните `wsl --shutdown`` может менять состояние проекта, registry, remote, контейнера или окружения. Перед запуском проверьте имена объектов, права и текущий контекст.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-19.