vue3自定义搭建项目

一、环境

Vue CLI 3需要 nodeJs ≥ 8.9 (官方推荐 8.11.0+，你可以使用 nvm 或 nvm-windows在同一台电脑中管理多个 Node 版本）

1、下载安装node
下载地址：https://nodejs.org/en/
2、检查是否安装成功

二、安装

1、全局安装过旧版本的 vue-cli(1.x 或 2.x)要先卸载它，否则跳过此步：

npm uninstall vue-cli -g //或者 yarn global remove vue-cli

2、安装@vue/cli（Vue CLI 3的包名称由 vue-cli 改成了 @vue/cli）

1 cnpm install -g @vue/cli //yarn global add @vue/cli

3、vue -V 检查vue版本号

三、使用

1、创建项目

vue create 项目名

【1】提示你选择一个preset（预设）：

① default（babel，eslint）：默认设置（直接enter）非常适合快速创建一个新项目的原型，没有带任何辅助功能的 npm包

② Manually select features：自定义配置（按方向键 ↓）是我们所需要的面向生产的项目，提供可选功能的 npm 包

【2】我选的Manually select features然后回车如下图：
按空格即为选中或取消

解释：

  ( ) Babel //转码器，可以将ES6代码转为ES5代码，从而在现有环境执行。 
  ( ) TypeScript// TypeScript是一个JavaScript（后缀.js）的超集（后缀.ts）包含并扩展了 JavaScript 的语法，需要被编译输出为 JavaScript在浏览器运行，目前较少人再用
  ( ) Progressive Web App (PWA) Support// 渐进式Web应用程序
  ( ) Router // vue-router（vue路由）
  ( ) Vuex // vuex（vue的状态管理模式）
  ( ) CSS Pre-processors // CSS 预处理器（如：less、sass）
  ( ) Linter / Formatter // 代码风格检查和格式化（如：ESlint）
  ( ) Unit Testing // 单元测试（unit tests）
  ( ) E2E Testing // e2e（end to end） 测试

【3】配置好之后回车，选择版本

【4】我选了vue3，然后回车，选择对应功能的具体工具包
① 是否使用history router：n

② css预处理器

③ ESLint：

提供一个插件化的javascript代码检测工具，ESLint + Prettier //使用较多

④ 何时检测：
Lint on save 保存就检查，Lint and fix on commit fix 或者 commit 的时候检查，建议第一个

⑤ 如何存放配置 ：
In dedicated config files 存放到独立文件中，In package.json 存放到 package.json 中

本着项目结构简单的想法，我选择了第二个

⑥ 是否保存本次配置（y:记录本次配置，然后需要你起个名; n：不记录本次配置）：

⑦ 搭建完成：

vue-cli升级到3之后，减少了很多的配置文件，将所有的配置项都浓缩到了vue.config.js这个文件中。

在根目录 新建一个 vue.config.js 同名文件

① 基本路径

baseUrl从 Vue CLI 3.3 起已弃用使用publicPath来替代。

在开发环境下，如果想把开发服务器架设在根路径，可以使用一个条件式的值

module.exports = {
 publicPath: process.env.NODE_ENV === 'production' ? '/production-sub-path/' : '/'
}

② 构建输出目录（打包位置）outputDir

module.exports = {
 outputDir: 'dist',
}

③ 静态资源目录 assetsDir
放置生成的静态资源 (js、css、img、fonts) 的目录

module.exports = {
 assetsDir: 'assets',
}

④ eslint代码检测 有效值：ture | false | ‘error’

设置为 true 时， eslint-loader 会将 lint 错误输出为编译警告。默认情况下，警告仅仅会被输出到命令行，且不会使得编译失败

希望让 lint 错误在开发时直接显示在浏览器中，可以使用 lintOnSave: ‘error’ 。这会强制 eslint-loader 将 lint 错误输出为编译错误

module.exports = {
  lintOnSave:false,//这里禁止使用eslint-loader
 
}

⑤ webpack-dev-server 相关配置

devServer: {
  open: true,//设置自动打开
  port: 1880,//设置端口
  proxy: {
   //设置代理
　　　　　　'/axios': {
　　　　　　　　target: 'http://101.15.22.98',
　　　　　　　　changeOrigin: true,
　　　　　　　　secure: false, //如果是http接口，需要配置该参数
　　　　　　　　pathRewrite: {
　　　　　　　　　　'^/axios': ''
　　　　　　　　　　}
　　　　　　　　}
   }
  }
 }

module.exports = {
 // 部署应用时的基本 URL
 publicPath: process.env.NODE_ENV === 'production' ? '192.168.60.110:8080' : '192.168.60.110:8080',

 // build时构建文件的目录 构建时传入 --no-clean 可关闭该行为
 outputDir: 'dist',

 // build时放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录
 assetsDir: '',

 // 指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
 indexPath: 'index.html',

 // 默认在生成的静态资源文件名中包含hash以控制缓存
 filenameHashing: true,

 // 构建多页面应用，页面的配置
 pages: {
  index: {
   // page 的入口
   entry: 'src/index/main.js',
   // 模板来源
   template: 'public/index.html',
   // 在 dist/index.html 的输出
   filename: 'index.html',
   // 当使用 title 选项时，
   // template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title>
   title: 'Index Page',
   // 在这个页面中包含的块，默认情况下会包含
   // 提取出来的通用 chunk 和 vendor chunk。
   chunks: ['chunk-vendors', 'chunk-common', 'index']
  },
  // 当使用只有入口的字符串格式时，
  // 模板会被推导为 `public/subpage.html`
  // 并且如果找不到的话，就回退到 `public/index.html`。
  // 输出文件名会被推导为 `subpage.html`。
  subpage: 'src/subpage/main.js'
 },

 // 是否在开发环境下通过 eslint-loader 在每次保存时 lint 代码 (在生产构建时禁用 eslint-loader)
 lintOnSave: process.env.NODE_ENV !== 'production',

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

 // Babel 显式转译列表
 transpileDependencies: [],

 // 如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建
 productionSourceMap: true,

 // 设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性（注：仅影响构建时注入的标签）
 crossorigin: '',

 // 在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)
 integrity: false,

 // 如果这个值是一个对象，则会通过 webpack-merge 合并到最终的配置中
 // 如果你需要基于环境有条件地配置行为，或者想要直接修改配置，那就换成一个函数 (该函数会在环境变量被设置之后懒执行)。该方法的第一个参数会收到已经解析好的配置。在函数内，你可以直接修改配置，或者返回一个将会被合并的对象
 configureWebpack: {},

 // 对内部的 webpack 配置（比如修改、增加Loader选项）(链式操作)
 chainWebpack: () =>{

 },

 // css的处理
 css: {
  // 当为true时，css文件名可省略 module 默认为 false
  modules: true,
  // 是否将组件中的 CSS 提取至一个独立的 CSS 文件中,当作为一个库构建时，你也可以将其设置为 false 免得用户自己导入 CSS
  // 默认生产环境下是 true，开发环境下是 false
  extract: false,
  // 是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能
  sourceMap: false,
  //向 CSS 相关的 loader 传递选项(支持 css-loader postcss-loader sass-loader less-loader stylus-loader)
  loaderOptions: {
   css: {},
   less: {}
  }
 },

 // 所有 webpack-dev-server 的选项都支持
 devServer: {},

 // 是否为 Babel 或 TypeScript 使用 thread-loader
 parallel: require('os').cpus().length > 1,

 // 向 PWA 插件传递选项
 pwa: {},

 // 可以用来传递任何第三方插件选项
 pluginOptions: {}
}

目前小颖公司用的 vue.config.js配置内容如下：

module.exports = {
 devServer: {
 proxy: {
  '/api': {
  target: 'http://xxxx',
  ws: true,
  changeOrigin: true,
  pathRewrite: {
   '^/api': ''
  }
  }
 }
 }
}