⚠️ Vue CLI 处于维护模式!

对于新项目,现在建议使用 create-vue 来搭建基于 Vite 的项目。还可以参考 Vue 3 工具指南 获取最新建议。

故障排除

本文档介绍了一些常见的 Vue CLI 问题以及如何解决它们。在打开新问题之前,您应该始终遵循以下步骤。

使用 sudoroot 权限运行安装

如果您以 root 用户身份或使用 sudo 安装 @vue/cli-service,则在运行包 postinstall 脚本时可能会出现问题。

这是 npm 的安全功能。您应该始终避免使用 root 权限运行 npm,因为安装脚本可能无意中具有恶意性。

但是,如果您必须这样做,可以通过设置 npm 的 --unsafe-perm 标志来解决此错误。这可以通过在命令前添加环境变量来完成,例如

npm_config_unsafe_perm=true vue create my-project

如果存在由 npm linkyarn link 安装的依赖项,ESLint(有时还有 Babel)可能无法为这些符号链接的依赖项正常工作。这是因为 webpack 默认情况下会将符号链接解析到其真实位置,从而破坏 ESLint / Babel 配置查找。

解决此问题的解决方法是在 webpack 中手动禁用符号链接解析

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

警告

禁用 resolve.symlinks 可能会破坏热模块替换,如果您的依赖项是由使用符号链接的第三方 npm 客户端安装的,例如 cnpmpnpm