故障排除
本文档介绍了一些常见的 Vue CLI 问题以及如何解决它们。在打开新问题之前,您应该始终遵循以下步骤。
使用 sudo
或 root
权限运行安装
如果您以 root
用户身份或使用 sudo
安装 @vue/cli-service
,则在运行包 postinstall
脚本时可能会出现问题。
这是 npm 的安全功能。您应该始终避免使用 root 权限运行 npm,因为安装脚本可能无意中具有恶意性。
但是,如果您必须这样做,可以通过设置 npm 的 --unsafe-perm
标志来解决此错误。这可以通过在命令前添加环境变量来完成,例如
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
。