vuecli3脚手架的使用和相关配置

jiezi

5 年前

通过 @vue/cli 搭建交互式的项目脚手架。
通过 @vue/cli + @vue/cli-service-global 快速开始零配置原型开发。
一个运行时依赖 (@vue/cli-service)，该依赖：

可升级；基于 webpack 构建，并带有合理的默认配置；可以通过项目内的配置文件进行配置；可以通过插件进行扩展。

一个丰富的官方插件集合，集成了前端生态中最好的工具。
一套完全图形化的创建和管理 Vue.js 项目的用户界面。
Vue CLI 致力于将 Vue 生态中的工具基础标准化。它确保了各种构建工具能够基于智能的默认配置即可平稳衔接，这样你可以 专注在撰写应用 上，而不必花好几天去纠结配置的问题。与此同时，它也为每个工具提供了调整配置的灵活性，无需 eject。

安装 vue-cli3;

注意 vue-cli3 要求 node 版本 8 或者更高以上，（推荐 8.10.0+）
安装命令 npm install –g @vue/cli
或者 cnpm install –g @vue/cli 或者 yarn global add @vue/cli
检测是否安装成功

创建项目：

vue create hello-world

第一次创建的时候应该之后后面两个选项，defalut是默认的，包含了 babel 和 eslint; Manually select features是可以手动选择所需要的插件；而 demo 是作者之前配置过的，保留下来的配置；

按上下箭头选择配置，空格键选中, 选择完成后，回车键继续，会依次问询你所选插件的配置，

vue-router 选择模式

所用的 css 预处理语言, 我选择了 sass;

选择的代码风格和格式校验

代码校验方式，我选择了保存即校验，也可以在 add 和 commit 的时候校验；

在哪里保存配置我这些插件的配置，我选择了独立文件

是否保存为保存为一个将来可复用的 preset；
选择完毕之后开始安装插件：

看一下安装完成的项目目录

安装完成之后，cd hello-world, 进入文件夹，npm run serve 启动项目；
你也可以使用图形化界面
可以通过 vue ui 命令以图形化界面创建和管理项目：

不做重点讲解；

配置 api 的地址配置参考 #
项目搭建完成，因为 vue-cli 3 的项目初始化，帮开发者已经解决了 80%，甚至绝大部分情形下的 webpack 配置。但开发过程中难免要遇到需要开发者自己配置的点东西，那我们要如何配置呢，这点就需要在项目根目录下手动新建一个 vue.config.js，此处我提供的一个我们项目中的常用模版；针对以下选项做大概的讲解；

const path = require('path')
const webpack = require('webpack')
module.exports = {
  // 修改 output.path
  outputDir: 'dist',
  // 修改 output.publishPath
  baseUrl: './',
  chainWebpack: config => {
    // 添加全局 scss 文件
    const types = ['vue-modules', 'vue', 'normal-modules', 'normal']
    types.forEach(type => {config.module.rule('scss').oneOf(type).use('style-resource')
        .loader('style-resources-loader')
        .options({
          patterns: [path.resolve(__dirname, 'src/css/base.scss')
          ]
        })
    })
    // 移除 prefetch 插件 // 预加载
    config.plugins.delete('prefetch')
    // 引入
    const chunkFolder = process.env.NODE_ENV !== 'production' ? 'debug' : 'dist'
    config.plugin('dll-reference-plugin')
      .use(webpack.DllReferencePlugin)
      .tap(options => {options[0] = {
          context: __dirname,
          manifest: require(path.join(__dirname, `./src/common_chunk/${chunkFolder}/manifest.json`))
        }
        return options
      })
    config.plugin('add-asset-html-webpack-plugin')
      .use('add-asset-html-webpack-plugin')
      .tap(options => {options[0] = {filepath: path.resolve(__dirname, `./src/common_chunk/${chunkFolder}/lib_*.js`)
        }
        return options
      })
  }
}

baseUrl：从 Vue CLI 3.3 起已弃用，请使用 publicPath
publicPath

Type: string
Default: '/'
部署应用包时的基本 URL。用法和 webpack 本身的 output.publicPath 一致，但是 Vue CLI 在一些其他地方也需要用到这个值，所以请始终使用 publicPath 而不要直接修改 webpack 的 output.publicPath。默认情况下，Vue CLI 会假设你的应用是被部署在一个域名的根路径上，例如 http://shop.ktvsky.com/。如果应用被部署在一个子路径上，你就需要用这个选项指定这个子路径。例如，如果你的应用被部署在 http://shop.ktvsky.com/vue/，则设置 publicPath 为 /vue/。也可以使用相对路径 './', 这样你打包的文件就可以部署到任意位置了

outputDir

Type: string 
Default: 'dist'
当运行 vue-cli-service build 时生成的生产环境构建文件的目录。注意目标目录在构建之前会被清除 (构建时传入 --no-clean 可关闭该行为)。

chainWebpack
我们将在下篇文章里详细讲述 chainWebpack 的使用；
官方文档 https://cli.vuejs.org/zh/guid…

vuecli3脚手架的使用和相关配置

前言

快速创建一个项目

vue.config.js