npm LinuxWindowsnpm

npm: Команда npm run build не находит установленный исполняемый файл

  • Обновлено
  • Чтение ≈ 3 минуты

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

При npm run build появляется «command not found», «is not recognized» либо ENOENT для программы сборки. Причина обычно в зависимости, отсутствующем локальном исполняемом файле или ошибке команды в scripts, а не в настройке глобального PATH.

В этой статье
  1. Симптомы и условия возникновения
  2. Причины и как их отличить
  3. Пошаговая диагностика и решение
  4. Как проверить результат и что делать, если не помогло

#Симптомы и условия возникновения

При npm run build появляется «command not found», «is not recognized» либо ENOENT для программы сборки. Причина обычно в зависимости, отсутствующем локальном исполняемом файле или ошибке команды в scripts, а не в настройке глобального PATH. Для начала проверьте используемую версию среды и точный текст ошибки на копии проекта, не меняя рабочий сервер.

#Причины и как их отличить

Возможная причинаКак узнатьЧто делать
Нет dev-зависимостиВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.Пакет вроде vite/tsc указан в devDependencies, но установился production-наборВ тестовой сборочной среде включить devDependencies.
Неверное имя в scriptsВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.Скрипт ссылается на устаревшую командуСверить имя bin по документации установленного пакета.
Запуск из неверного проектаВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.Собирается другой package.jsonПерейти в каталог нужного приложения.

#Пошаговая диагностика и решение

  1. 1. Скопируйте строку ошибки и имя командыЗапустите скрипт в копии проекта и посмотрите первый отсутствующий исполняемый файл, например vite, tsc или webpack; не следует переустанавливать все пакеты до идентификации конкретного инструмента.
  1. 2. Проверьте script в package.jsonОткройте package.json → scripts → build. Найдите команду до первого пробела и сравните с именем bin, которое предоставляет пакет. Синтаксис команд Windows и Linux различается, особенно в установке переменных среды.
  1. 3. Убедитесь, что npm работает в нужном каталогеВ терминале выполните npm pkg get scripts.build, убедитесь, что вы видите ожидаемый скрипт. Если вывод undefined, у текущего пакета нет такого сценария.
  2. Чтение из package.json текущего проекта
    Linux · Терминал (Bash)Команда
    Чтение из package.json текущего проекта. Наличие строки подтверждает правильную папку.
    npm pkg get scripts.build
  1. 4. Проверьте установку зависимостиЗапустите npm ls имя-пакета --depth=0. Если пакет отсутствует, убедитесь, что он указан как зависимость проекта, а не только установлен глобально.
  1. 5. Сверьте режим установкиПроверьте NODE_ENV, настройку omit и наличие пакета в devDependencies. На стадии сборки в копии выполните npm ci --include=dev с подтверждённым lock-файлом.
  2. Только в тестовой папке: удаляет локальный node_modules и запускает скрипты установки
    Linux · Терминал (Bash)С осторожностью
    Только в тестовой папке: удаляет локальный node_modules и запускает скрипты установки.
    npm ci --include=dev

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

  1. 6. Найдите локальный исполняемый файлПосмотрите node_modules/.bin после установки. На Windows исполняемый файл может быть .cmd, в Linux/macOS — ссылка/скрипт; npm run сам добавляет этот каталог в PATH, поэтому глобальная установка не нужна.
  1. 7. Повторите сборкуВ копии проекта выполните npm run build, проверьте наличие ожидаемого результата (dist/build, если так определено проектом), код возврата и лог ошибок. При новой ошибке компиляции разбирайте её отдельно.

#Как проверить результат и что делать, если не помогло

Локальный инструмент запускается из npm run build, сборка создаёт предусмотренные файлы, а глобальные системные пакеты менять не пришлось.

Если неисправность повторилась, выпишите первый код ошибки и действие, на котором она возвращается. Сравните версию Node.js/npm, рабочий каталог, настройки процесса и журнал тестового запуска. Откатите только внесённые изменения из предварительно сохранённой копии, затем разберите причину на отдельной среде.

Так эту ошибку тоже называют

npm ERR! ERESOLVE unable to resolve dependency tree — причины и решение Исправьте конфликт peer-зависимостей или используйте --legacy-peer-deps. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! EACCES permission denied при глобальной установке — причины и решение Настройте префикс npm в домашней папке или используйте nvm; не используйте sudo. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! code ELIFECYCLE — сбой скрипта — причины и решение ELIFECYCLE означает, что скрипт из package.json завершился с ошибкой. Прочитайте лог выше, удалите node_modules и lock-файл и повторите установку. Программирование и базы данных npm LinuxWindowsmacOS npm ERR! ETIMEDOUT и ECONNRESET — не загружаются пакеты — причины и решение Проверьте прокси, зеркало реестра и сеть. Программирование и базы данных npm LinuxWindowsmacOS 404 npm ERR! 404 Not Found — пакет не найден — причины и решение Пакет не существует, опечатка в имени или приватный реестр без авторизации. Проверьте имя и настройки реестра. Программирование и базы данных npm LinuxWindowsmacOS

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.