⚠️ Vue CLI is in Maintenance Mode!

For new projects, it is now recommended to use create-vue to scaffold Vite-based projects. Also refer to the Vue 3 Tooling Guide for the latest recommendations.

Поиск и устранение неисправностей

В это документе рассматриваются некоторые общие проблемы, касающиеся Vue CLI, и способы их решения. Прежде чем открывать новый issue, всегда выполняйте следующие действия.

Запуск установки через sudo или как root

Если устанавливаете @vue/cli-service как пользователь root или с помощью sudo, то могут возникнуть проблемы при запуске скриптов postinstall пакета.

Это функция безопасности npm. Вы всегда должны избегать запуска npm с привилегиями root, потому что сценарии установки скриптов могут быть непреднамеренно вредоносными.

Однако, если необходимо, то можно обойти эту ошибку, установив флаг --unsafe-perm для npm. Это реализуется путём добавления префикса с переменной окружения к команде:

npm_config_unsafe_perm=true vue create my-project

Символические ссылки в node_modules

Если есть зависимости, установленные через npm link или yarn link, ESLint (а иногда и Babel) могут работать некорректно для этих слинкованных зависимостей. Это происходит потому, что по умолчанию webpack разрешает символические ссылки на их настоящее местоположение, таким образом ломая поиск конфигурации ESLint / Babel.

Обходным решением этой проблемы будет отключение вручную разрешения символических ссылок в webpack:

// vue.config.js
module.exports = {
  chainWebpack: (config) => {
    config.resolve.symlinks(false)
  }
}

ПРЕДУПРЕЖДЕНИЕ

Отключение resolve.symlinks может сломать горячую перезагрузку модулей, если ваши зависимости устанавливались сторонними npm-клиентами, использующие символические ссылки, такие как cnpm или pnpm.