n1ro°
RU

Ошибки и коды · Инструкция

npm run: command not found внутри script

Выполните `npm run` без имени и убедитесь, что нужный script существует. Откройте строку `scripts` и найдите первое имя

Редакция N1RO · Проверено

Короткий ответ

Проверьте наличие script в `package.json` и локальной CLI-зависимости; `npm run` добавляет `node_modules/.bin` в PATH, поэтому после корректного `npm ci` нужный binary должен находиться без глобальной установки.

Проверка по порядку

  • Выполните `npm run` без имени и убедитесь, что нужный script существует.
  • Откройте строку `scripts` и найдите первое имя команды, которое shell не может запустить.
  • Проверьте, объявлен ли пакет этой CLI в dependencies/devDependencies.

Исправление

  1. Запустите `npm ci`, чтобы восстановить локальные binaries строго по lockfile.
  2. Проверьте CLI через `npm exec -- <command> --version` или содержимое `node_modules/.bin`.
  3. Если проблема только на одной ОС/CI, проверьте shell-specific синтаксис script и сделайте его переносимым.

Как понять, что исправлено

  • npm run запускает локальный binary без глобальной установки, а npm exec видит ту же CLI-версию из проекта.

Важно

Глобальная установка CLI может скрыть отсутствующий devDependency и сломать воспроизводимость CI. Сначала восстановите локальные dependencies.

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

Глобальная установка CLI может скрыть отсутствующий devDependency и сломать воспроизводимость CI. Сначала восстановите локальные dependencies.

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

Фактическая часть сверена по первичным источникам (в т.ч. npm run). Пример и формулировки — редакция N1RO на 2026-09-17.