60个Vue常见问题汇总及解决方案

来源 | https://www.fly63.com/

Q1：安装超时(install timeout)

方案有这么些:

cnpm : 国内对npm的镜像版本
/*
cnpm website: https://npm.taobao.org/
*/
npm install -g cnpm --registry=https://registry.npm.taobao.org


// cnpm 的大多命令跟 npm 的是一致的,比如安装,卸载这些
yarn 和 npm 改源大法


//使用 nrm 模块 : www.npmjs.com/package/nrm
npm config : npm config set registry https://registry.npm.taobao.org
yarn config : yarn config set registry https://registry.npm.taobao.org

Q2：安装一些需要编译的包:提示没有安装python、build失败等 

因为一些 npm 的包安装需要编译的环境,mac 和 linux 都还好,大多都齐全 window 用户依赖 visual studio 的一些库和python 2+, windows的小伙伴都装上: windows-build-tools python 2.x

Q3：can’t not find ‘xxModule’ - 找不到某些依赖或者模块

这种情况一般报错信息可以看到是哪个包抛出的信息.，一般卸载这个模块,安装重新安装下即可.

Q4：data functions should return an object

这个问题是 vue 实例内,单组件的data必须返回一个对象;如下

export default {
  name: 'page-router-view',
      data () {
      return {
        tabs: [
          {
            title: '财务信息',
            url: '/userinfo'
          },
          {
            title: '帐号信息',
            url: '/userinfo/base'
          }
        ]
      }
    }
}

为什么要 return 一个数据对象呢? 官方解释如下: data 必须声明为返回一个初始数据对象的函数，因为组件可能被用来创建多个实例。如果 data 仍然是一个纯粹的对象，则所有的实例将共享引用同一个数据对象！简言之,组件复用下,不会造成数据同时指向一处,造出牵一发而动全身的破问题...

Q5：我给组件内的原生控件添加事件,怎么不生效了!!!

  
  {{item.menuName}}




  
  {{item.menuName}}

Q6：我用了 axios , 为什么 IE 浏览器不识别(IE9+)

那是因为 IE 整个家族都不支持 promise, 解决方案:
npm install es6-promise
// 在 main.js 引入即可
// ES6的polyfill
require("es6-promise").polyfill();

Q7：我在函数内用了this.xxx=,为什么抛出Cannot set property ‘xxx’ of undefined;

这又是this的套路了..this是和当前运行的上下文绑定的... 

一般你在axios或者其他 promise , 或者setInterval 这些默认都是指向最外层的全局钩子. 

简单点说:"最外层的上下文就是 window,vue内则是 Vue 对象而不是实例!"; 

解决方案: 

暂存法: 函数内先缓存 this , let that = this;(let是 es6, es5用 var) 
箭头函数: 会强行关联当前运行区域为 this 的上下文; 

Q8：我看一些Vue教程有这么些写法,是什么意思@click.prevent,v-demo.a.b;

就拿这两个例子来说吧. 

@click.prevent : 事件+修饰符 , 作用就是点击但又阻止默认行为。

v-demo.a.b: 自定义指令+修饰符. 具体看你什么指令了,修饰符的作用大多是给事件增加一些确切的拓展功能，比如阻止事件冒泡,阻止默认行为,访问到原生控件,结合键盘快捷键等等 。

可以自定义修饰符么?也是可以的。可以通过全局 config.keyCodes 对象自定义键值修饰符别名：

Q9：为什么我的引入的小图片渲染出来却是 data:image/png;base64xxxxxxxx

这个是 webpack 里面的对应插件处理的，对于小于多少 K 以下的图片(规定的格式)直接转为 base64格式渲染; 

具体配置在webpack.base.conf.js里面的rules里面的 url-loader，这样做的好处:在网速不好的时候先于内容加载和减少http的请求次数来减少网站服务器的负担。

Q10：Component template shold contain exactly one root element.If you are useing v-if on multiple elements , xxxxx

大体就是说,单组件渲染 DOM 区域必须要有一个根元素,不能出现同级元素. 可以用v-if和v-else-if指令来控制其他元素达到并存的状态。

换个直白的解释,就是有一个唯一的父类,包裹者; 比如一个 div(父包含块) 内部多少个同级或者嵌套都行,但是最外层元素不能出现同级元素!

Q11：跨域问题怎么破!比如No ‘Access-Control-Allow-Origin’ header is present on the requested resource.

这种问题老生常谈了,我就不细说了..大体说一下; 

1: CORS , 前后端都要对应去配置,IE10+ 
2: nginx 反向代理,一劳永逸 <-- 线上环境可以用这个

线下开发模式,比如你用了vue-cli, 里面的 webpack 有引入了proxyTable这么个玩意, 也可以做接口反向代理。

// 在 config 目录下的index.js
proxyTable: {
  "/bp-api": {
    target: "http://new.d.st.cn",
    changeOrigin: true,
    // pathRewrite: {
    //   "^/bp-api": "/"
    // }
  }
}


// target : 就是 api 的代理的实际路径
// changeOrigin: 就是是变源,必须是...
// pathRewrite : 就是路径重定向,一看就知道

当然还有依旧坚挺的jsonp大法!不过局限性比较多,比较适合一些特殊的信息获取!

Q12：我需要遍历的数组值更新了,值也赋值了,为什么视图不更新!

那是因为有局限性啊,官方文档也说的很清楚,只有一些魔改的之后的方法提供跟原生一样的使用姿势(却又可以触发视图更新);

一般我们更常用(除了魔改方法)的手段是使用:this.$set(obj,item,value);

Q13：为什么我的组件间的样式不能继承或者覆写啊!

单组件开发模式下,请确认是否开启了 css模块化功能!也就是scoped(vue-cli 里面配置了,只要加入这个属性就自动启用)。

为什么不能继承或者覆写呢,那时因为每个类或者 id 乃至标签都会给自动在css后面添加hash! 比如：

// 写的时候是这个
.trangle{}
// 编译过后,加上了 hash
.trangle[data-v-1ec35ffc]{}

这些都是在 css-loader 里面配置!!!

Q14：路由模式改为history后,除了首次启动首页没报错,刷新访问路由都报错!

必须给对应的服务端配置查询的主页面..也可以认为是主路由入口的引导。

官方文档也有,为毛总有人不喜欢去看文档,总喜欢做伸手党。

Q15：我想拦截页面,或者在页面进来之前做一些事情,可以么?

可以的，各种路由器的钩子!!当然,记忆滚动的位置也可以做到,详情翻翻官网里面的文档。

Q16：TypeError: xxx is not a function

这种问题明显就是写法有问题...能不能动点脑子!!

Q17：Uncaught ReferenceError: xxx is not define

实例内的 data 对应的变量没有声明，你导入模块报这个错误,那绝逼是导出没写好。

Q18：Error in render function:”Type Error: Cannot read property ‘xxx’ of undefined”

这种问题大多都是初始化的姿势不对;比如引入echart这些...仔细去了解下生命周期,再来具体初始化;

vue 组件有时候也会(嵌套组件或者 props传递初始化)..也是基本这个问题

Q19：Unexpected token: operator xxxxx

大佬,这个一看就是语法错误啊，基本都是符号问题， 一般报错会给出哪一行或者哪个组件。

Q20：npm run build之后不能直接访问

大佬!你最起码得在本地搭个服务器才能访问好么!!

Q21：CSSbackground引入图片打包后,访问路径错误

因为打包后图片是在根目录下,你用相对路径肯定报错啊....

你可以魔改 webpack 的配置文件里面的static为./static...但是不建议。你若是把图片什么丢到assets目录下,然后相对路径,打包后是正常的。

Q22：安装模块时命令窗口输出unsupported platform xxx

一般两种情况,node版本不兼容,系统不兼容; 

 解决方案: 要么不装,要么满足安装要求;

Q23：Unexpected tab charater这些

一般是你用脚手架初始化的时候开了 eslint ;要么遵循规则,要么改变规则;要么直接把 webpack 里面的 eslint 检测给关闭了。

Q24：Failed to mount component: template or render function not defined

组件挂载失败,问题只有这么几个 

组件没有正确引入; 
挂载点顺序错了了; 自行动手排查

Q25：Unknown custom element: - did you register the component correctly?

组件没有正确引入或者正确使用,依次确认

导入对应的组件
在 components 内声明 
在 dom 区域声明标签

Q26：axios的 post 请求后台接受不到!

axios默认是 json 格式提交,确认后台是否做了对应的支持;若是只能接受传统的表单序列化,就需要自己写一个转义的方法...当然还有一个更加省事的方案,装一个小模块qs.

npm install qs -S
// 然后在对应的地方转就行了..单一请求也行,拦截器也行...我是写在拦截器的.
// 具体可以看看我 axios 封装那篇文章
//POST传参序列化(添加请求拦截器)
Axios.interceptors.request.use(
  config => {
    // 在发送请求之前做某件事
    if (
      config.method === "post"
    ) {
      // 序列化
      config.data = qs.stringify(config.data); // ***** 这里转义
    }


    // 若是有做鉴权token , 就给头部带上token
    if (localStorage.token) {
      config.headers.Authorization = localStorage.token;
    }
    return config;
  },
  error => {
    Message({
      //  饿了么的消息弹窗组件,类似toast
      showClose: true,
      message: error,
      type: "error.data.error.message"
    });
    return Promise.reject(error.data.error.message);
  }
);

Q27：Invalid prop: type check failed for prop “xxx”. Expected Boolean, got String.

这种问题一般就是组件内的 props 类型已经设置了接受的范围类型, 而你传递的值却又不是它需要的类型,写代码严谨些 OK?

Q28：过滤器可以用于DOM区域结合指令么?

// 不行,看下面的错误例子
{{item}}
// `vue2+`的指令只能用语 mustache`{{}}` , 正确姿势如下:
{{ message | capitalize }}

Q29：[…Array],…mapState,[SOME_MUTATION] (state) {},increment ({ commit }) {}这种写法是什么鬼!

ES6+(ES2015)的基础去过一遍..上面依次:数组解构,对象解构,对象风格函数,对象解构赋值传递。

Q30：我的 Vue 网站为什么 UC 访问一片空白亦或者flex布局错乱!!

来来来,墙角走起.... UC 号称移动界的 IE 这称号不是白叫的。flexbox 布局错乱,一般是你没有把兼容方案写上..就是带各种前缀,复合属性拆分。

UC访问空白, 有一种情况绝对会造成,那就是 ES6的代码降级不够彻底. 其他情况可能就是路由配置问题(自己去排除)，现在的开发都推荐按需引入,靠babel-preset-env 来控制,以达到打包体积减小。

但是这样做的后果,有些内核比较老的...嘿嘿..拜拜。所以最好把代码完全 ES5话!!记住有些特性不能乱使用,没有对应的 polyfill,比如 ES6 的proxy

Q31：this.$set | this.$xxx 这个 $ 是个什么意思?是 jQuery的么,会冲突么?

且看我细细道来.

Vue 的$和 jQuery 的$并没有半毛钱的关系,就跟 JavaScript 和java一样.
Vue 的$是封装了一些 vue 的内建函数,然后导出以$开头...这显然并不是 jQuery的专利;
jQuery 的$是选择器!!取得 DOM区域...两者的作用完全不一致!

Q32：Error in event handler for “click”:”xxx”

这个问题大多都是你写的代码有问题.你的事件触发了,但是组件内部缺少对应的实现或者变量,所以抛出事件错误。

解决方案:看着报错慢慢排查

Q33： 组件的通讯有哪几种啊!

基本最常用的是这几种;

父传子: props 
子传父: emit
兄弟通讯:event bus: 就是找一个中间组件来作为信息传递中介 
vuex: 信息树

Q34：vuex的用户信息为什么还要存一遍在浏览器里(sessionStorage or localStorage)

因为 vuex的 store 干不过刷新啊，保存在浏览器的缓存内,若用户刷新的话,值再取一遍呗;

Q35：“有 Vue + Vue Router + Vuex”或什么”express + vue + mongodb”的项目学习么

Github 一搜一大堆,提这些问题的人动动脑子!

Q36：线上若是 nginx,如何部署?以及反向代理这些!

1.将node端的服务端口放入服务器的80端口，做反向代理，这里用的是3000端口来做示范

#先定义一个website变量，方便管理以后端口的变更，不会影响到后续的80端口其他的操作
upstream website{
  server 127.0.0.1:3000;
}
 
server {
  listen 80;
#业户逻辑... ...
####
  location / {
        proxy_pass    http://website;
        proxy_redirect default ;
  }
####  
}

Q37：“我会 Vue 我还需要学习 jQuery 或者原生 JS 么”

jQuery还有很多公司在用,源码可以学习的地方很多;原生 js 是根本,不管是哪个前端框架,最终都是 js 实现的;只有基础扎实,才能学的比较深...

框架只是加快开发,提高效率,但不是你在这一行长期立足的根本;

前端的人不仅需要宽度,也要深度...这样才能走的更远....

Q38：npm run dev 报端口错误!Error: listen EADDRINUSE :::8080

自己用 webpack搭脚手架的都不用我说了;Vue-cli 里面的 webpack 配置: config/index.js

dev: {
    env: require("./dev.env"),
    port: 8080, //  这里这里,若是这个端口已经给系统的其他程序占用了.改我改我!!!!!!
    autoOpenBrowser: true,
    assetsSubDirectory: "static",
    assetsPublicPath: "/",
    proxyTable: {
      "/bp-api": {
        target: "http://new.d.st.cn",
        changeOrigin: true,
        // pathRewrite: {
        //   "^/bp-api": "/"
        // }
    }
},

Q39：什么时候用v-if,什么用 v-show!

我们先来说说两者的核心差异;

v-if : DOM 区域没有生成,没有插入文档..等条件成立的时候才动态插入到页面!有些需要遍历的数组对象或者值,最好用这货控制,等到拿到值才处理遍历,不然一些操作过快的情况会报错,比如数据还没请求到!
v-show: DOM 区域在组件渲染的时候同时渲染了,只是单纯用 css 隐藏了，对于下拉菜单,折叠菜单这些数据基本不怎么变动.用这个最合适了..而且可以改善用户体验,因为它不会导致页面的重绘,DOM 操作会!

简言之: DOM结构不怎么变化的用v-show, 数据需要改动很大或者布局改动的用v-if

Q40：