Vue-cli3.0搭建和一些坑

偶尔善良 提交于 2020-03-10 11:13:48

[2018-07-31更新]: vue-cli 3.0正式版的中文文档已经出来了,详细的可以参考:https://cli.vuejs.org/zh/guide/

一、安装Vue和创建项目:

# 安装
npm install -g @vue/cli注:快捷键win+R,输入cmd并运行,默认C盘,可设置对应的磁盘,如F盘, 输入cd\到C盘更目录,再输入f:进入F盘,最后就是自己自定义的文件夹cd vue

# 查看已安装版本
vue --version 或者 vue -V

# 卸载
npm uninstall @vue/cli -g

# 新建项目
vue create my-project注:创建自定义项目(my-porject)的时候,可自定义设置项目相关配置,可以End默认,如果设置了的可以在vue.config.js配置文件中再次修改。

# 项目启动
npm run serve

# 打包
npm run build

 二、Vue相关配置--vue.config.js

 Vue-cli3.0的配置不同于之前版本,大大的简化了开发者工作,更人性化,只有一个配置文件-vue.config.js。

常用配置:1、样式预处理less,sass,公共样式文件设置

     2、端口设置和热加载

     3、第三方插件

vue.config.js --- 基础模版

module.exports = {
  baseUrl: process.env.NODE_ENV === 'production'
    ? '//your_url'
    : '/',
  outputDir: 'dist', //生成的生产环境构建文件的目录
  assetsDir: 'static',  // 放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录。
   indexPath: 'index.html',  //指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
  filenameHashing: true,

  // When building in multi-pages mode, the webpack config will contain different plugins
  // (there will be multiple instances of html-webpack-plugin and preload-webpack-plugin).
  // Make sure to run vue inspect if you are trying to modify the options for those plugins.  // 在 multi-page 多页面模式下构建应用。每个“page”应该有一个对应的 JavaScript 入口文件,多页面配置(web,h5等),当前只有一个单页面,可以不用配置  pages: {
    index: {
      // entry for the pages
      entry: 'src/pages/index/index.js',
      // the source template
      template: 'src/pages/index/index.html',
      // output as dist/index.html
      filename: 'index.html',
      // when using title option,
      // template title tag needs to be <title><%= htmlWebpackPlugin.options.title %></title>
      title: '首页',
      // chunks to include on this pages, by default includes
      // extracted common chunks and vendor chunks.
      chunks: ['chunk-vendors', 'chunk-common', 'index']
    }
    // when using the entry-only string format,
    // template is inferred to be `public/subpage.html`
    // and falls back to `public/index.html` if not found.
    // Output filename is inferred to be `subpage.html`.
    // subpage: ''
  },

  // eslint-loader 是否在保存的时候检查
  lintOnSave: true,

  // 是否使用包含运行时编译器的Vue核心的构建
  runtimeCompiler: false,

  // 默认情况下 babel-loader 忽略其中的所有文件 node_modules
  transpileDependencies: [],

  // 生产环境 sourceMap
  productionSourceMap: false,

  // cors 相关 https://jakearchibald.com/2017/es-modules-in-browsers/#always-cors
  // corsUseCredentials: false,
  // webpack 配置,键值对象时会合并配置,为方法时会改写配置
  // https://cli.vuejs.org/guide/webpack.html#simple-configuration
  configureWebpack: (config) => {
     resolve: {
 
  alias: {
'@': resolve('src')
  }
},
plugins: [
  // webpack 配置jq, 配置目录别名
  new webpack.ProvidePlugin({
 $: "jquery",
 jQuery: "jquery",
"windows.jQuery": "jquery"
  })
]  
// webpack 链接 API,用于生成和修改 webapck 配置
  // https://github.com/mozilla-neutrino/webpack-chain
  chainWebpack: (config) => {
    // 因为是多页面,所以取消 chunks,每个页面只对应一个单独的 JS / CSS
    config.optimization
      .splitChunks({
        cacheGroups: {}
      });

    // 'src/lib' 目录下为外部库文件,不参与 eslint 检测
    config.module
      .rule('eslint')  // 不想校验可以注释掉    .use('vue-loader')     .loader('vue-loader')
  },

  // 配置高于chainWebpack中关于 css loader 的配置
  css: {
    // 是否开启支持 foo.module.css 样式
    modules: false,

    // 是否使用 css 分离插件 ExtractTextPlugin,采用独立样式文件载入,不采用 <style> 方式内联至 html 文件中
    extract: true,

    // 是否构建样式地图,false 将提高构建速度
    sourceMap: false,

    // css预设器配置项
    loaderOptions: {    modules: false,    extract: true,    sourceMap: false,    css: {
        // options here will be passed to css-loader     data: `@import "@/assets/sass/base.scss";` //导入公共样式文件      },

      postcss: {
        // options here will be passed to postcss-loader
      }
    }
  },

  // All options for webpack-dev-server are supported
  // https://webpack.js.org/configuration/dev-server/
  devServer: {
    open: true,

    host: '127.0.0.1',

    port: 3000,  // 如果端口冲突,配置端口号

    https: false,

    hotOnly: false,

    proxy: null,

    before: app => {
    }
  },
  // 构建时开启多进程处理 babel 编译
  parallel: require('os').cpus().length > 1,

  // https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-pwa
  pwa: {},

  // 第三方插件配置
  pluginOptions: {}
};

 三、一些报错的坑

 1、npm run dev 运行报错 

failed at the xxx deve script 'node build/dev-server.js'

 解决方案:该问题是因为脚手架工具默认监听的是8080端口,此时是8080端口被占用情况导致的,可以需选择杀死端口,可以自定义端口,如:3000, 9000。

2、Media query expression must begin with '('   编译时报错

解决方案:scss编译的问题,style中scss中使用{},lang='scss',在应用公共样式文件base.scss,

data: `@import "@/assets/sass/base.scss";`后面一定要带上分号‘;’

 

 

 

 
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!