vue老项目升级vue-cli3.0问题总结【转发】

升级步骤
1、 删除原vue-cli并安装vue-cli3.0
2、删除新项目中src下的内容,把原项目中src目录覆盖到新项目中
3、把router从目录文件夹改为文件,src/router/index.js提高一层变成src/router.js
4、 我的项目中src已经分为了views和components所以无需修改,如果不是这个结构需要自己区分下
5、将原项目的index.html及favicon.ico覆盖到新项目的public中
6、 将原项目的static文件夹拷贝到新项目的public中
7、 修改package.json文件,保持和原有项目一致即可
8、 创建并配置vue.config.js文件

删除命令:

npm uninstall vue-cli -g

安装@vue/cli命令:

npm install -g @vue/cli

我在这里省略安装流程,掘金上已经有很多文章了,下面说下会遇到的问题:

1、找不到vue文件

CMD中的报错

These dependencies were not found:* @/views/index/index in ./src/router.js* @/views/index/otherIndex in ./src/router.jsTo install them, you can run: npm install --save @/views/index/index @/views/index/other

页面上的报错

./src/router.jsModule not found:Error: Can't resolve '@/views/index/index' in 'D:\VUE\haigui-proxy\src'
这种报错是说明文件路径错误没有找到文件,因为在原项目中设置了“@”也就是alias(别名),也有可能在原项目中设置了extensions(可以省略扩展名),所以需要在新项目的vue.config.js中设置如下内容:

const path = require('path'); // vue.config.js顶部const resolve = (dir) => path.join(__dirname, dir);module.exports = {  configureWebpack: config => {    Object.assign(config, {      resolve: {        extensions: ['.js', '.vue', '.json'], // 可以省略后缀名        alias: { // 别名,在require的时候,可以使用这些别名,来缩短路径的长度          '@': path.resolve(__dirname, './src'),          '@c': path.resolve(__dirname, './src/components')        }      }    });  }}

2、找不到image图片

Module not found:Error: Can't resolve '../../../static/image/avatar_gray.jpg' in 'D:\VUE\haigui-proxy\src\views\index'

当把原项目的src和static拷贝到新项目后,就会出现图片路径不对的问题,网上很多有关vue-cli3.0配置的文章都说的是把原项目的static直接拷贝到新项目的public中,其实这是不对,官方给出的原因是:

任何放置在 public 文件夹的静态资源都会被简单的复制,而不经过 webpack。需要通过绝对路径来引用它们。

例如,目录为public/static/image,image里面存放各种图片:

引入图片logo.png:

 

在 css 中 设置背景图片:

.bg {  background: url('/satic/image/bg.jpg');}

注意:

public ****目录提供的是一个应急手段,当你通过绝对路径引用它时,留意应用将会部署到哪里。如果你的应用没有部署在域名的根部,那么你需要为你的 URL 配置 publicPath 前缀。

何时使用 public 文件夹

  • 你需要在构建输出中指定一个文件的名字。
  • 你有上千个图片,需要动态引用它们的路径。
  • 有些库可能和 webpack 不兼容,这时你除了将其用一个独立的 标签引入没有别的选择。

通过 webpack 的处理好处:

  • 脚本和样式表会被压缩且打包在一起,从而避免额外的网络请求。
  • 文件丢失会直接在编译时报错,而不是到了用户端才产生 404 错误。
  • 最终生成的文件名包含了内容哈希,因此你不必担心浏览器会缓存它们的老版本。
  • public 目录提供的是一个应急手段,当你通过绝对路径引用它时,留意应用将会部署到哪里。

assets****文件夹就是用来放置经过webpack处理的资源的

需要使用相对路径引入:


img动态路径:

data () {  return {        imgurl: require("../assets/images/gou.png")    }}

css 背景图:

.login-wrapper {  background: url('../../assets/images/bg.jpg');}

参考:官方解释

3、scss全局变量的配置

Module build failed (from ./node_modules/sass-loader/lib/loader.js):Undefined variable.  955 │        border-right: 1px solid $borderColor;                            ^^^^^^^^^^^^root stylesheet in D:\VUE\haigui-proxy\src\views\index\index.vue (line 955, column 33)

若原项目中使用了scss并且使用了全局变量,需要在vue.config.js中重新配置,并把全局变量文件放到src/assets/css目录下

在原项目中需要在build/utils.js中进行配置

scss: generateLoaders('sass').concat(  {    loader: 'sass-resources-loader',    options: {      resources: path.resolve(__dirname, '../src/assets/css/haigui-variable.scss')    }  })

新项目中就简单的多,直接编辑vue.config.js,加入一节内容即可:

css: {  loaderOptions: {    sass: {      // @/ 是 src/ 的别名 ~是必须有要加的      data: '@import "~@/assets/css/haigui-variable";'      // 如果没有设置别名可以这么写      // data: '@import "./src/assets/css/haigui-variable";'    }  }}

4、runtime-only

You are using the runtime-only build of Vue where the template compiler is notavailable. Either pre-compile the templates into render functions, or use thecompiler-included build.

原因:vue有两种形式的代码 compiler(模板)模式和runtime模式(运行时),vue模块的package.json的main字段默认为runtime模式, 指向了"dist/vue.runtime.common.js"位置。

这是vue升级到2.0之后就有的特点。

而在main.js文件中,初始化vue却是这么写的,这种形式为compiler模式的,所以就会出现上面的错误信息。

new Vue({  el: '#app',  router,  store,  components: { App },  template: ''});

解决办法:

方法一:将main.js中的代码修改如下就可以

new Vue({  router,  store,  render: h => h(App)}).$mount('#app')

到这里我们的问题还没完,那为什么之前是没问题的,之前vue版本也是2.x的呀?

这也是第二种解决办法:因为之前我们的webpack配置文件里有个别名配置,具体如下

resolve: {  alias: {      'vue$': 'vue/dist/vue.esm.js' //内部为正则表达式 vue结尾的  }}

也就是说,import Vue from ‘vue’ 这行代码被解析为 import Vue from ‘vue/dist/vue.esm.js’,直接指定了文件的位置,没有使用main字段默认的文件位置。

所以第二种解决方法就是,在vue.config.js文件里加上webpack的如下配置即可,

configureWebpack: {  resolve: {    alias: {      'vue$': 'vue/dist/vue.esm.js'     }  }}

既然到了这里就会想到第三中解决方法,那就是在引用vue时,直接写成如下即可

import Vue from 'vue/dist/vue.esm.js'

你可能感兴趣的:(vue老项目升级vue-cli3.0问题总结【转发】)