Текст и данные · Инструкция
npm explore запустить команду в каталоге зависимости
`npm explore` нужен, когда надо открыть shell или выполнить одну диагностическую команду прямо в каталоге уже установленной зависимости. Он удобен для проверки содержимого пакета в `node_modules`, но не превращает ручную правку зависимости в воспроизводимое исправление проекта.
Короткий ответ
Используйте `npm explore <pkg>` для shell внутри каталога установленной зависимости или `npm explore <pkg> -- <command>` для разового запуска. После ручного изменения пакета npm не перестраивает его автоматически.
Что меняют node_modules и subshell
`npm explore <pkg>` запускает subshell в каталоге установленного пакета, указанного по имени. Если после `--` передана команда, npm выполняет её в этом каталоге и сразу завершает subshell. Ручные изменения внутри зависимости не вызывают автоматический rebuild; если это действительно требуется для локальной диагностики, перестройку выполняют отдельно.
Совет: Перед `explore` полезно записать точную версию пакета: так вывод диагностики можно сопоставить с lock-файлом.
Как выполнить задачу и не сломать установленная зависимость
- Шаг 1: Убедитесь, что нужный пакет уже установлен в текущем проекте, и зафиксируйте чистое состояние рабочей копии.
- Шаг 2: Для интерактивного просмотра выполните `npm explore <pkg>`; для одной команды используйте `npm explore <pkg> -- <command>`.
- Шаг 3: Проверьте текущий каталог и выполняйте только диагностические команды, не полагаясь на изменения внутри `node_modules` как на постоянное исправление.
- Шаг 4: Выйдите из subshell; если вы осознанно меняли содержимое пакета для локального теста, восстановите зависимость или выполните требуемую перестройку и повторите тест.
Проверка после npm explore
- Пакет уже установлен именно в том проекте, из которого запускается команда.
- Для разового действия команда передана после `--`, а не введена в случайном shell.
- Текущий каталог внутри subshell совпадает с нужной зависимостью и версией.
- Любая временная правка в `node_modules` отделена от постоянного решения в исходниках проекта.
- После выхода повторён основной тест; при необходимости зависимость восстановлена или перестроена осознанно.
Предупреждение: Не коммитьте содержимое `node_modules` ради сохранения эксперимента — это маскирует причину и ломает воспроизводимость.
Когда `npm explore` полезнее ручного `cd` в node_modules
Команда сама находит каталог указанного установленного пакета и запускает там subshell; вариант после `--` выполняет переданную команду и завершает shell. Это снижает риск открыть одноимённую папку не из того дерева зависимостей, особенно у scoped-пакетов. Для расследования удобно сначала вывести текущий путь и версию пакета, затем выполнить только чтение или временный эксперимент. Если для проверки вы всё же изменили файлы зависимости, зафиксируйте diff отдельно: следующая установка может стереть его, а npm не запускает автоматический rebuild только из-за выхода из `explore`.
Почему изменения в node_modules легко потерять
Не используйте `npm explore` как способ постоянно редактировать код в `node_modules`: такие изменения легко теряются при следующей установке и не воспроизводятся в CI.
Как понять, что команда выполнена правильно
Считайте диагностику завершённой, когда вы можете повторить одну и ту же команду через `npm explore` и получить ожидаемый результат без неучтённых правок в `node_modules`. Если поведение меняется только после ручного редактирования установленного пакета, перенесите исправление в собственный код, patch-механизм или обновление зависимости, а не оставляйте локальное состояние как решение.
Важно: Критерий успеха здесь — повторяемая команда в правильном каталоге, а не просто открывшийся shell.
Что учитывать
Не используйте `npm explore` как способ постоянно редактировать код в `node_modules`: такие изменения легко теряются при следующей установке и не воспроизводятся в CI.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. npm-explore | npm Docs). Пример и формулировки — редакция N1RO на 2026-09-23.