Vue 脱坑记 - 查漏补缺(汇总下群里高频询问的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 模块 : 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:安装一些需要编译的包:提示没有安装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:我用了 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指令来控制其他元素达到并存的状态

换个直白的解释,就是有一个唯一的父类,包裹者;

比如一个 div(父包含块) 内部多少个同级或者嵌套都行,但是最外层元素不能出现同级元素!!!!


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: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: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: 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: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 布局错乱,一般是你没有把兼容方案写上..就是带各种前缀,复合属性拆分
    • 看看我这篇文章:移动端爬坑记 --- (1)布局与样式上的奇葩偶遇, 最好就用插件来代替人力吧,,引入 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 or localStorage)

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


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

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


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

传送门:一篇不大靠谱的nginx 1.11.10配置文件


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

jQuery还有很多公司在用,源码可以学习的地方很多;

原生 js 是根本,不管是哪个前端框架,最终都是 js 实现的;
只有基础扎实,才能学的比较深...

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

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


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: