Ошибки и коды · Инструкция
Как исправить npm ERESOLVE из-за peer dependencies
ERESOLVE чаще означает невозможность собрать дерево при текущих constraints, а не повреждённый cache.
Короткий ответ
Прочитайте блок ERESOLVE, найдите несовместимые peer ranges и измените прямые версии так, чтобы диапазоны пересекались. `--legacy-peer-deps` и `--force` — обходы, а не доказательство совместимости.
Порядок действий
- Сохраните полный Found/Could not resolve dependency блок.
- Проверьте `npm ls` и peerDependencies конфликтующих пакетов.
- Подберите совместимые версии прямых зависимостей.
- Обновите lockfile и запустите тесты.
- Если нужен временный legacy-peer-deps, зафиксируйте причину и срок.
Перед завершением проверьте
- Найдены именно конфликтующие peer ranges.
- Lockfile не удаляется без понимания причины.
Важно
`--force` может установить дерево, которое авторы пакетов не объявляли совместимым.
Что учитывать
`--force` может установить дерево, которое авторы пакетов не объявляли совместимым.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. npm-install). Пример и формулировки — редакция N1RO на 2026-09-20.