Vue 2.x脱坑记 - 查漏补缺(汇总下群里高频询问的xxx及给出不靠谱的解决方案)

前言

文章内容覆盖范围,芝麻绿豆的破问题都有,不止于vue;

给出的是方案,而非手把手一字一句的给你说十万个为什么!

问题汇总

Q:安装超时(install timeout)

方案有这么些:

  • cnpm : 国内对npm的镜像版本
/*
cnpm website: https://npm.taobao.org/
*/

npm install -g cnpm --registry=https://registry.npm.taobao.org

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

  • 使用 nrm 模块 : https://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

Q: 想学习Vue,要先学习脚手架的搭建么

若是你想快速上手,用官方的脚手架即可(Vue-Cli 3)

因为不管是webpack还是parcelgulp,都是一些构建工作流的东东;

学习脚手架的搭建,更多的是要针对项目业务进行定制,调优;

一般入门级的无需太早考虑这方面的,只要专心学好Vue的使用姿势便可。

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

因为一些 npm 的包安装需要编译的环境,maclinux 都还好,

而window 用户依赖 visual studio 的一些库python 2+,

windows的小伙伴都装上:

  • windows-build-tools
  • python 2.x

Q:can't not find 'xxModule' - 找不到某些依赖或者模块

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

Q: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 仍然是一个纯粹的对象,则所有的实例将共享引用同一个数据对象!

简言之,组件复用下,不会造成数据同时指向一处,造出牵一发而动全身的破问题,

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





<el-input placeholder="请输入特定消费金额 " @mouseover="test()">el-input>



<router-link :to="item.menuUrl" @click="toggleName=''">
  <i :class="['fzicon',item.menuIcon]">i>
  <span>{{item.menuName}}span>
router-link>




<router-link :to="item.menuUrl" @click.native="toggleName=''">
  <i :class="['fzicon',item.menuIcon]">i>
  <span>{{item.menuName}}span>
router-link>




Q: provideinject是什么

Vue 在2.2的时候,也提供了该概念。类比ng providerreact context;

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

那是因为 IE 整个家族都不支持 promise, 解决方案:


npm install es6-promise

// 在 main.js 引入即可
// ES6的polyfill
require("es6-promise").polyfill();

Q:我在函数内用了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 的上下文;

this的知识, 读"<<你不知道的 JS 系列>>"最为合适了,里面讲的很清楚

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

  • @click.prevent : 事件+修饰符 , 作用就是点击但又阻止默认行为
  • v-demo.a.b: 自定义指令+修饰符. 具体看你什么指令了,修饰符的作用大多是给事件增加一些确切的拓展功能

比如阻止事件冒泡,阻止默认行为,访问到原生控件,结合键盘快捷键等等

传送门:事件修饰符;

可以自定义修饰符么?也是可以的,

可以通过全局 config.keyCodes 对象自定义键值修饰符别名:

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

这个是 webpack 里面的对应插件处理的.

对于小于多少 K 以下的图片(规定的格式)直接转为 base64格式渲染;

具体配置在webpack.base.conf.js里面的 rules里面的 url-loader

这样做的好处:在网速不好的时候先于内容加载和减少http的请求次数来减少网站服务器的负担。

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

大体就是说,单组件渲染 DOM 区域必须要有一个根元素,

可以用v-ifv-else-if指令来控制其他元素达到并存的状态

Q:跨域问题怎么破!

比如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大法!不过局限性比较多,比较适合一些特殊的信息获取!

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

那是因为有局限性啊,官方文档也说的很清楚,

只有一些魔改的之后的方法提供跟原生一样的使用姿势(可以触发视图更新);

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

传送门:数组更新检测(触发视图更新)

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

单组件开发模式下,请确认是否开启了 CSS模块化功能!!

也就是scoped(vue-cli 里面配置了,只要加入这个属性就自动启用)

<style lang="scss" scoped>style>

为什么不能简单的继承或者覆写呢,是因为每个类或者 id 乃至标签都会给自动在css后面添加自定义属性hash!

比如

// 写的时候是这个
.trangle{}

// 编译过后,加上了 hash
.trangle[data-v-1ec35ffc]{}

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

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

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

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

传送门 : Vue-Router history Mode

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

Of course !!

各种路由器的钩子!! 传送门: 导航守卫;

当然,记忆滚动的位置也可以做到,详情翻翻里面的文档

Q:TypeError: xxx is not a function

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

Q: 能不能跨级拿到props

这种情况是面向嵌套层次很深的组件,又要拿到上层的父传递的东东,

可以用$attrs 或者inject + provide来实现

Q:Uncaught ReferenceError: xxx is not define

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

Q:Error in render function:"Type Error: Cannot read property 'xxx' of undefined"

这种问题大多都是初始化的姿势不对;

比如引入echart这些,仔细去了解下生命周期,再来具体初始化;

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

Q:Unexpected token: operator xxxxx

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

Q:npm run build之后不能直接访问

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

Q: 操作Vue的原型链好么

这个问题需要具体情况具体分析;

我看很多人喜欢把axios挂载到Vue.prototype上;

这样做有一定的弊端,相当耦合,若是多人维护或者替换其他库的时候有一定困难;

比较好的做法是不挂载,而是单独有服务请求的文件,用函数来封装你所需要的接口聚合;

这样统一暴露函数名,而内部实现可以随便改动

Q:CSSbackground引入图片打包后,访问路径错误

因为打包后图片是在根目录下,你用相对路径肯定报错啊,.
你可以魔改 webpack 的配置文件里面的static./static,但是不建议

你若是把图片什么丢到assets目录下,然后相对路径,打包后是正常的

Q:安装模块时命令窗口输出unsupported platform xxx

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

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

Q:Unexpected tab charater这些

一般是你用脚手架初始化的时候开了 eslint ;

要么遵循规则,要么改变规则;

要么直接把 webpack 里面的 eslint 检测给关闭了

Q:Failed to mount component: template or render function not defined

组件挂载失败,问题只有这么几个,组件没有正确引入或挂载点顺序错了了。

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

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

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

Q: 如何让自定义组件支持Vue.use使用呢

只要暴露一个install函数即可,大体可以看下以下代码;


import BtnPopconfirm from './BtnPopconfirm.vue';
BtnPopconfirm.install = function(Vue) {
  Vue.component(BtnPopconfirm.name, BtnPopconfirm);
};
export default BtnPopconfirm;


// 然后就支持Vue.use了

Q: axiospost 请求后台接受不到!

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);
  }
);

Q: Vue支持jsx的写法么

可以很确定的告诉你,是支持的;

但是和React是有所差异的,而非完全等同的,具体可以看官方的支持库(https://github.com/vuejs/jsx)

Q: Invalid prop: type check failed for prop "xxx". Expected Boolean, got String.

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

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

// 不行,看下面的错误例子
<li v-for="(item,index) in range | sortByDesc | spliceText">{{item}}li>

// `vue2+`的指令只能用语 mustache`{{}}` , 正确姿势如下:

<span>{{ message | capitalize }}span>

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

出门左拐,ES6+(ES2015+)的基础去过一遍,

上面依次:数组解构,对象解构,对象风格函数,对象解构赋值传递

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

来来来,墙角走起,. UC 号称移动界的 IE 这称号不是白叫的

  • flexbox 布局错乱,一般是你没有把兼容方案写上,就是带各种前缀,复合属性拆分,引入 autoprefixer, 写上兼容范围就好了.
  • UC访问空白, 有一种情况绝对会造成,那就是 ES6的代码降级不够彻底. 其他情况可能就是路由配置问题(自己去排除)
  • 现在的开发都推荐按需引入,靠babel-preset-env 来控制,以达到打包体积减小.
  • 但是这样做的后果,有些内核比较老的,嘿嘿,拜拜,
  • 所以最好把代码完全 ES5话!!记住有些特性不能乱使用,没有对应的 polyfill,比如 ES6 的proxy

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

且看我细细道来.

Vue 的$和 jQuery 的$并没有半毛钱的关系,就跟javascriptjava一样.

Vue 的$是封装了一些 vue 的内建函数,然后导出以$开头,这显然并不是 jQuery的专利;

jQuery 的$是选择器!!取得 DOM区域,两者的作用完全不一致!

Q:Module not found: Error : Can't resolve 'xxx-loader' in xxxx

这里问题一般就是webpack的配置文件你改动了或对应的loader 没有装上

Q: 父组件可以直接调用子组件的方法么!

可以,通过$refs或者$chilren来拿到对应的实例,从而操作

Q:Error in event handler for "click":"xxx"

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

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

Q: 组件的通讯有哪几种啊!

基本最常用的是这三种;

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

传送门:

  • 基本通讯
  • Vuex

Q:既然localStoragesessionStorage能做到数据维护,为什么还要引入vuex!

这个问题问得好,Vuex的目的用来维护同级组件间的数据通讯,拥有一个共同的状态树;

仅仅活在SPA的里面的**伪多页(路由)**内, 这种东东明明然localStoragesessionStorage
也可以做到,还能做到跨页面数据维护,还不会被浏览器刷新干掉,

为什么还要引入 vuex, 我个人觉得原因只有这么一个,"可维护性"和"易用性"及

怎么理解呢?

  • 可维护性: 因为是单向数据流,所有状态是有迹可循的,数据的传递也可以及时分发响应
  • 易用性: 它使得我们组件间的通讯变得更强大,而不用借助中间件这类来实现不同组件间的通讯

而且代码量不多,若是你要用 ls或者ss,你必须手动去跟踪维护你的状态表,
虽说可行,但是代码量会多很多,而且可读性很差,

是不是每个项目都需要用到vuex?
答案是否定的,小型项目上这个反而是累赘,这东西一般是用在中型项目+的,
因为里面涉及需要维护的数据比较多,同级组件间的通讯比较频繁

若是用到vuex的项目记得结合ss或者ls来达到某些状态持久化!为什么看下面!

Q:vuex的用户信息为什么还要存一遍在浏览器里(sessionStorage或localStorage)

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

Q:"有 Vue + Vue Router + Vuex"或什么"express + vue + mongodb"的项目学习么

Github 一搜一大堆,提这些问题的人动动脑子!.传送门:Github

Q:我会 Vue 我还需要学习 jQuery 或者原生 JS

jQuery还有很多公司在用,源码可以学习的地方很多,框架只是加快开发,提高效率,但不是你在这一行长期立足的根本;

大佬们都是各种设计模式和算法玩的好,才能写出这么优秀的框架。

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

Q: 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": "/"
        // }
      }
    },

Q: 什么时候用v-if,什么用 v-show!

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

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

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

Q: