+
+
+
+
+
+```
+
+[▲ 回顶部](#top)
+
+### ✅ VantUI 组件按需加载
+
+项目采
+用[Vant 自动按需引入组件 (推荐)](https://youzan.github.io/vant/#/zh-CN/quickstart#fang-shi-yi.-zi-dong-an-xu-yin-ru-zu-jian-tui-jian)下
+面安装插件介绍：
+
+[babel-plugin-import](https://github.com/ant-design/babel-plugin-import) 是一款 `babel` 插件，它会在编译过程中将
+`import` 的写法自动转换为按需引入的方式
+
+#### 安装插件
+
+```bash
+npm i babel-plugin-import -D
+```
+
+在`babel.config.js` 设置
+
+```javascript
+// 对于使用 babel7 的用户，可以在 babel.config.js 中配置
+const plugins = [
+ [
+ 'import',
+ {
+ libraryName: 'vant',
+ libraryDirectory: 'es',
+ style: true
+ },
+ 'vant'
+ ]
+]
+module.exports = {
+ presets: [['@vue/cli-plugin-babel/preset', { useBuiltIns: 'usage', corejs: 3 }]],
+ plugins
+}
+```
+
+#### 使用组件
+
+项目在 `src/plugins/vant.js` 下统一管理组件，用哪个引入哪个，无需在页面里重复引用
+
+```javascript
+// 按需全局引入 vant组件
+import Vue from 'vue'
+import { Button, List, Cell, Tabbar, TabbarItem } from 'vant'
+Vue.use(Button)
+Vue.use(Cell)
+Vue.use(List)
+Vue.use(Tabbar).use(TabbarItem)
+```
+
+[▲ 回顶部](#top)
+
+### ✅ Sass 全局样式
+
+首先 你可能会遇到 `node-sass` 安装不成功，别放弃多试几次！！！
+
+每个页面自己对应的样式都写在自己的 .vue 文件之中 `scoped` 它顾名思义给 css 加了一个域的概念。
+
+```html
+
+
+
+```
+
+#### 目录结构
+
+vue-h5-template 所有全局样式都在 `@/src/assets/css` 目录下设置
+
+```bash
+├── assets
+│ ├── css
+│ │ ├── index.scss # 全局通用样式
+│ │ ├── mixin.scss # 全局mixin
+│ │ └── variables.scss # 全局变量
+```
+
+#### 自定义 vant-ui 样式
+
+现在我们来说说怎么重写 `vant-ui` 样式。由于 `vant-ui` 的样式我们是在全局引入的，所以你想在某个页面里面覆盖它的样式就不能
+加 `scoped`，但你又想只覆盖这个页面的 `vant` 样式，你就可在它的父级加一个 `class`，用命名空间来解决问题。
+
+```css
+.about-container {
+ /* 你的命名空间 */
+ .van-button {
+ /* vant-ui 元素*/
+ margin-right: 0px;
+ }
+}
+```
+
+#### 父组件改变子组件样式 深度选择器
+
+当你子组件使用了 `scoped` 但在父组件又想修改子组件的样式可以 通过 `>>>` 来实现：
+
+```css
+
+```
+
+#### 全局变量
+
+`vue.config.js` 配置使用 `css.loaderOptions` 选项,注入 `sass` 的 `mixin` `variables` 到全局，不需要手动引入 ,配
+置`$cdn`通过变量形式引入 cdn 地址,这样向所有 Sass/Less 样式传入共享的全局变量：
+
+```javascript
+const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV)
+const defaultSettings = require('./src/config/index.js')
+module.exports = {
+ css: {
+ extract: IS_PROD,
+ sourceMap: false,
+ loaderOptions: {
+ // 给 scss-loader 传递选项
+ scss: {
+ // 注入 `sass` 的 `mixin` `variables` 到全局, $cdn可以配置图片cdn
+ // 详情: https://cli.vuejs.org/guide/css.html#passing-options-to-pre-processor-loaders
+ prependData: `
+ @import "assets/css/mixin.scss";
+ @import "assets/css/variables.scss";
+ $cdn: "${defaultSettings.$cdn}";
+ `
+ }
+ }
+ }
+}
+```
+
+设置 js 中可以访问 `$cdn`,`.vue` 文件中使用`this.$cdn`访问
+
+```javascript
+// 引入全局样式
+import '@/assets/css/index.scss'
+
+// 设置 js中可以访问 $cdn
+// 引入cdn
+import { $cdn } from '@/config'
+Vue.prototype.$cdn = $cdn
+```
+
+在 css 和 js 使用
+
+```html
+
+
+```
+
+[▲ 回顶部](#top)
+
+### ✅ Vuex 状态管理
+
+目录结构
+
+```bash
+├── store
+│ ├── modules
+│ │ └── app.js
+│ ├── index.js
+│ ├── getters.js
+```
+
+`main.js` 引入
+
+```javascript
+import Vue from 'vue'
+import App from './App.vue'
+import store from './store'
+new Vue({
+ el: '#app',
+ router,
+ store,
+ render: h => h(App)
+})
+```
+
+使用
+
+```html
+
+```
+
+[▲ 回顶部](#top)
+
+### ✅ Vue-router
+
+本案例采用 `hash` 模式，开发者根据需求修改 `mode` `base`
+
+**注意**：如果你使用了 `history` 模式，`vue.config.js` 中的 `publicPath` 要做对应的**修改**
+
+前往:[vue.config.js 基础配置](#base)
+
+```javascript
+import Vue from 'vue'
+import Router from 'vue-router'
+
+Vue.use(Router)
+export const router = [
+ {
+ path: '/',
+ name: 'index',
+ component: () => import('@/views/home/index'), // 路由懒加载
+ meta: {
+ title: '首页', // 页面标题
+ keepAlive: false // keep-alive 标识
+ }
+ }
+]
+const createRouter = () =>
+ new Router({
+ // mode: 'history', // 如果你是 history模式 需要配置 vue.config.js publicPath
+ // base: '/app/',
+ scrollBehavior: () => ({ y: 0 }),
+ routes: router
+ })
+
+export default createRouter()
+```
+
+更多:[Vue Router](https://router.vuejs.org/zh/)
+
+[▲ 回顶部](#top)
+
+### ✅ Axios 封装及接口管理
+
+`utils/request.js` 封装 axios ,开发者需要根据后台接口做修改。
+
+- `service.interceptors.request.use` 里可以设置请求头，比如设置 `token`
+- `config.hideloading` 是在 api 文件夹下的接口参数里设置，下文会讲
+- `service.interceptors.response.use` 里可以对接口返回数据处理，比如 401 删除本地信息，重新登录
+
+```javascript
+import axios from 'axios'
+import store from '@/store'
+import { Toast } from 'vant'
+// 根据环境不同引入不同api地址
+import { baseApi } from '@/config'
+// create an axios instance
+const service = axios.create({
+ baseURL: baseApi, // url = base api url + request url
+ withCredentials: true, // send cookies when cross-domain requests
+ timeout: 5000 // request timeout
+})
+
+// request 拦截器 request interceptor
+service.interceptors.request.use(
+ config => {
+ // 不传递默认开启loading
+ if (!config.hideloading) {
+ // loading
+ Toast.loading({
+ forbidClick: true
+ })
+ }
+ if (store.getters.token) {
+ config.headers['X-Token'] = ''
+ }
+ return config
+ },
+ error => {
+ // do something with request error
+ console.log(error) // for debug
+ return Promise.reject(error)
+ }
+)
+// respone拦截器
+service.interceptors.response.use(
+ response => {
+ Toast.clear()
+ const res = response.data
+ if (res.status && res.status !== 200) {
+ // 登录超时,重新登录
+ if (res.status === 401) {
+ store.dispatch('FedLogOut').then(() => {
+ location.reload()
+ })
+ }
+ return Promise.reject(res || 'error')
+ } else {
+ return Promise.resolve(res)
+ }
+ },
+ error => {
+ Toast.clear()
+ console.log('err' + error) // for debug
+ return Promise.reject(error)
+ }
+)
+export default service
+```
+
+#### 接口管理
+
+在`src/api` 文件夹下统一管理接口
+
+- 你可以建立多个模块对接接口, 比如 `home.js` 里是首页的接口这里讲解 `user.js`
+- `url` 接口地址，请求的时候会拼接上 `config` 下的 `baseApi`
+- `method` 请求方法
+- `data` 请求参数 `qs.stringify(params)` 是对数据系列化操作
+- `hideloading` 默认 `false`,设置为 `true` 后，不显示 loading ui 交互中有些接口不需要让用户感知
+
+```javascript
+import qs from 'qs'
+// axios
+import request from '@/utils/request'
+//user api
+
+// 用户信息
+export function getUserInfo(params) {
+ return request({
+ url: '/user/userinfo',
+ method: 'post',
+ data: qs.stringify(params),
+ hideloading: true // 隐藏 loading 组件
+ })
+}
+```
+
+#### 如何调用
+
+```javascript
+// 请求接口
+import { getUserInfo } from '@/api/user.js'
+
+const params = { user: 'sunnie' }
+getUserInfo(params)
+ .then(() => {})
+ .catch(() => {})
+```
+
+[▲ 回顶部](#top)
+
+### ✅ Webpack 4 vue.config.js 基础配置
+
+如果你的 `Vue Router` 模式是 hash
+
+```javascript
+publicPath: './',
+```
+
+如果你的 `Vue Router` 模式是 history 这里的 publicPath 和你的 `Vue Router` `base` **保持一直**
+
+```javascript
+publicPath: '/app/',
+```
+
+```javascript
+const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV)
+
+module.exports = {
+ publicPath: './', // 署应用包时的基本 URL。 vue-router hash 模式使用
+ // publicPath: '/app/', // 署应用包时的基本 URL。 vue-router history模式使用
+ outputDir: 'dist', // 生产环境构建文件的目录
+ assetsDir: 'static', // outputDir的静态资源(js、css、img、fonts)目录
+ lintOnSave: !IS_PROD,
+ productionSourceMap: false, // 如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建。
+ devServer: {
+ port: 9020, // 端口号
+ open: false, // 启动后打开浏览器
+ overlay: {
+ // 当出现编译器错误或警告时，在浏览器中显示全屏覆盖层
+ warnings: false,
+ errors: true
+ }
+ // ...
+ }
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 配置 alias 别名
+
+```javascript
+const path = require('path')
+const resolve = dir => path.join(__dirname, dir)
+const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV)
+
+module.exports = {
+ chainWebpack: config => {
+ // 添加别名
+ config.resolve.alias
+ .set('@', resolve('src'))
+ .set('assets', resolve('src/assets'))
+ .set('api', resolve('src/api'))
+ .set('views', resolve('src/views'))
+ .set('components', resolve('src/components'))
+ }
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 配置 proxy 跨域
+
+如果你的项目需要跨域设置，你需要打来 `vue.config.js` `proxy` 注释 并且配置相应参数
+
+**!!!注意：你还需要将 `src/config/env.development.js` 里的 `baseApi` 设置成 '/'**
+
+```javascript
+module.exports = {
+ devServer: {
+ // ....
+ proxy: {
+ //配置跨域
+ '/api': {
+ target: 'https://test.xxx.com', // 接口的域名
+ // ws: true, // 是否启用websockets
+ changOrigin: true, // 开启代理，在本地创建一个虚拟服务端
+ pathRewrite: {
+ '^/api': '/'
+ }
+ }
+ }
+ }
+}
+```
+
+使用 例如: `src/api/home.js`
+
+```javascript
+export function getUserInfo(params) {
+ return request({
+ url: '/api/userinfo',
+ method: 'post',
+ data: qs.stringify(params)
+ })
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 配置 打包分析
+
+```javascript
+const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin
+
+module.exports = {
+ chainWebpack: config => {
+ // 打包分析
+ if (IS_PROD) {
+ config.plugin('webpack-report').use(BundleAnalyzerPlugin, [
+ {
+ analyzerMode: 'static'
+ }
+ ])
+ }
+ }
+}
+```
+
+```bash
+npm run build
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 配置 externals 引入 cdn 资源
+
+这个版本 CDN 不再引入，我测试了一下使用引入 CDN 和不使用,不使用会比使用时间少。网上不少文章测试 CDN 速度块，这个开发者可
+以实际测试一下。
+
+另外项目中使用的是公共 CDN 不稳定，域名解析也是需要时间的（如果你要使用请尽量使用同一个域名）
+
+因为页面每次遇到`
+ <% } %>
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 去掉 console.log
+
+保留了测试环境和本地环境的 `console.log`
+
+```bash
+npm i -D babel-plugin-transform-remove-console
+```
+
+在 babel.config.js 中配置
+
+```javascript
+// 获取 VUE_APP_ENV 非 NODE_ENV，测试环境依然 console
+const IS_PROD = ['production', 'prod'].includes(process.env.VUE_APP_ENV)
+const plugins = [
+ [
+ 'import',
+ {
+ libraryName: 'vant',
+ libraryDirectory: 'es',
+ style: true
+ },
+ 'vant'
+ ]
+]
+// 去除 console.log
+if (IS_PROD) {
+ plugins.push('transform-remove-console')
+}
+
+module.exports = {
+ presets: [['@vue/cli-plugin-babel/preset', { useBuiltIns: 'entry' }]],
+ plugins
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ splitChunks 单独打包第三方模块
+
+```javascript
+module.exports = {
+ chainWebpack: config => {
+ config.when(IS_PROD, config => {
+ config
+ .plugin('ScriptExtHtmlWebpackPlugin')
+ .after('html')
+ .use('script-ext-html-webpack-plugin', [
+ {
+ // 将 runtime 作为内联引入不单独存在
+ inline: /runtime\..*\.js$/
+ }
+ ])
+ .end()
+ config.optimization.splitChunks({
+ chunks: 'all',
+ cacheGroups: {
+ // cacheGroups 下可以可以配置多个组，每个组根据test设置条件，符合test条件的模块
+ commons: {
+ name: 'chunk-commons',
+ test: resolve('src/components'),
+ minChunks: 3, // 被至少用三次以上打包分离
+ priority: 5, // 优先级
+ reuseExistingChunk: true // 表示是否使用已有的 chunk，如果为 true 则表示如果当前的 chunk 包含的模块已经被抽取出去了，那么将不会重新生成新的。
+ },
+ node_vendors: {
+ name: 'chunk-libs',
+ chunks: 'initial', // 只打包初始时依赖的第三方
+ test: /[\\/]node_modules[\\/]/,
+ priority: 10
+ },
+ vantUI: {
+ name: 'chunk-vantUI', // 单独将 vantUI 拆包
+ priority: 20, // 数字大权重到，满足多个 cacheGroups 的条件时候分到权重高的
+ test: /[\\/]node_modules[\\/]_?vant(.*)/
+ }
+ }
+ })
+ config.optimization.runtimeChunk('single')
+ })
+ }
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ 添加 IE 兼容
+
+之前的方式 会报 `@babel/polyfill` is deprecated. Please, use required parts of `core-js` and
+`regenerator-runtime/runtime` separately
+
+`@babel/polyfill` 废弃，使用 `core-js` 和 `regenerator-runtime`
+
+```bash
+npm i --save core-js regenerator-runtime
+```
+
+在 `main.js` 中添加
+
+```javascript
+// 兼容 IE
+// https://github.com/zloirock/core-js/blob/master/docs/2019-03-19-core-js-3-babel-and-a-look-into-the-future.md#babelpolyfill
+import 'core-js/stable'
+import 'regenerator-runtime/runtime'
+```
+
+配置 `babel.config.js`
+
+```javascript
+const plugins = []
+
+module.exports = {
+ presets: [['@vue/cli-plugin-babel/preset', { useBuiltIns: 'usage', corejs: 3 }]],
+ plugins
+}
+```
+
+[▲ 回顶部](#top)
+
+### ✅ Eslint + Pettier 统一开发规范
+
+VScode 安装 `eslint` `prettier` `vetur` 插件
+
+在文件 `.prettierrc` 里写 属于你的 pettier 规则
+
+```bash
+{
+ "printWidth": 120,
+ "tabWidth": 2,
+ "singleQuote": true,
+ "trailingComma": "none",
+ "semi": false,
+ "wrap_line_length": 120,
+ "wrap_attributes": "auto",
+ "proseWrap": "always",
+ "arrowParens": "avoid",
+ "bracketSpacing": false,
+ "jsxBracketSameLine": true,
+ "useTabs": false,
+ "overrides": [{
+ "files": ".prettierrc",
+ "options": {
+ "parser": "json"
+ }
+ }]
+}
+```
+
+Vscode setting.json 设置
+
+```bash
+ "[vue]": {
+ "editor.defaultFormatter": "esbenp.prettier-vscode"
+ },
+ "[javascript]": {
+ "editor.defaultFormatter": "esbenp.prettier-vscode"
+ },
+ // 保存时用eslint格式化
+ "editor.codeActionsOnSave": {
+ "source.fixAll.eslint": true
+ },
+ // 两者会在格式化js时冲突，所以需要关闭默认js格式化程序
+ "javascript.format.enable": false,
+ "typescript.format.enable": false,
+ "vetur.format.defaultFormatter.html": "none",
+ // js/ts程序用eslint，防止vetur中的prettier与eslint格式化冲突
+ "vetur.format.defaultFormatter.js": "none",
+ "vetur.format.defaultFormatter.ts": "none",
+```
+
+[▲ 回顶部](#top)
+
+### ✅ vconsole 移动端调试
+参考地址：https://github.com/AlloyTeam/AlloyLever
+参考地址：https://www.cnblogs.com/liyinSakura/p/9883777.html
+```js
+import Vconsole from 'vconsole'
+const vConsole = new Vconsole()
+export default vConsole
+```
+* app.vue中设置暗门，点击几次显示vconsole
+ * 在app.vue中通过limit进行设置
+ * 开发测试环境点击一次就可显示
+ * 生产环境点击10次
+
+ 
+
e`SIB>!lwPOd{83r2^`S^&7VSHQy_N1S{O6}@_J_;+8@F?W
z;A_N5mA6V7KbML0XoRbLaky#D{g#YhWk*iv$Z?YaGH}{<1UB|9t9-Q=Z;$4`RF3vv
z3z6!E>w=r`JH4H{Ev?ozT0NJk%$g<_OKD0<