Текст и данные · Инструкция
Что делает npm install --legacy-peer-deps и когда его применять
Используйте как диагностический/переходный обход, затем исправьте диапазоны версий или дерево зависимостей. Ниже — после
Короткий ответ
`--legacy-peer-deps` заставляет npm обходиться с peer dependencies в старом стиле и может скрыть реальную несовместимость зависимостей. Практический вариант: `npm install --legacy-peer-deps`.
Что делать
- Проверьте исходное состояние: Работайте в нужном репозитории/проекте или контексте инструмента. До изменения зафиксируйте текущее состояние; для последующей проверки используйте `npm ls`.
- Выполните основное действие: Запустите `npm install --legacy-peer-deps`. Если команда содержит пример имени, тега, пакета, контейнера или дистрибутива — замените его своим значением.
- Проверьте результат: Выполните `npm ls` и сопоставьте вывод с целью страницы: временно игнорировать `peerdependencies` при построении дерева, когда старый проект не устанавливается с современным resolver. Не продолжайте автоматизацию, если проверка показывает другой объект или состояние.
- Зафиксируйте безопасный рабочий вариант: Если действие должно выполняться в CI или скрипте, сначала сохраните проверенную команду в локальном сценарии и добавьте явную обработку ненулевого кода возврата или отсутствующего объекта.
Перед запуском
- Вы находитесь в нужном проекте, репозитории, Docker context или Python/Node окружении.
- Команда проверки известна заранее: `npm ls`.
- Имена веток, тегов, пакетов, контейнеров и дистрибутивов заменены на ваши.
- Для необратимых удалённых действий есть резервный путь восстановления или подтверждение в UI/API.
Важно
Не копируйте пример вслепую. Команда `npm install --legacy-peer-deps` может менять состояние проекта, registry, remote, контейнера или окружения. Перед запуском проверьте имена объектов, права и текущий контекст.
Почему это работает
`--legacy-peer-deps` заставляет npm обходиться с peer dependencies в старом стиле и может скрыть реальную несовместимость зависимостей.
Проверка
- Основное действие: npm install --legacy-peer-deps
- Проверка: npm ls
Что учитывать
Не копируйте пример вслепую. Команда `npm install --legacy-peer-deps` может менять состояние проекта, registry, remote, контейнера или окружения. Перед запуском проверьте имена объектов, права и текущий контекст.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. npm install). Пример и формулировки — редакция N1RO на 2026-09-19.