vue-cli4+vant+rem+sass+vuex+axios封装+webpack搭建移动端项目

▲ 回顶部

✅ vm 适配方案

本项目使用的是 rem 的 适配方案，其实无论你使用哪种方案，都不需要你去计算 12px 是多少 rem 或者 vw, 会有专门的工具去帮你做

。如果你想用 vw，你可以按照下面的方式切换。

1.安装依赖

npm install postcss-px-to-viewport -D

2.修改 .postcssrc.js

将根目录下 .postcssrc.js 文件修改如下

// https://github.com/michael-ciniawsky/postcss-load-config

module.exports = {

plugins: {

autoprefixer: {

overrideBrowserslist: [‘Android 4.1’, ‘iOS 7.1’, ‘Chrome > 31’, ‘ff > 31’, ‘ie >= 8’]

},

‘postcss-px-to-viewport’: {

viewportWidth: 375, // 视窗的宽度，对应的是我们设计稿的宽度，一般是750

unitPrecision: 3, // 指定px转换为视窗单位值的小数位数（很多时候无法整除）

viewportUnit: ‘vw’, // 指定需要转换成的视窗单位，建议使用vw

selectorBlackList: [‘.ignore’, ‘.hairlines’], // 指定不转换为视窗单位的类，可以自定义，可以无限添加,建议定义一至两个通用的类名

minPixelValue: 1, // 小于或等于1px不转换为视窗单位，你也可以设置为你想要的值

mediaQuery: false // 允许在媒体查询中转换px

}

}

}

3.删除原来的 rem 相关代码

src/main.js 删除如下代码

// 移动端适配

import ‘lib-flexible/flexible.js’

package.json 删除如下代码

“lib-flexible”: “^0.3.2”,

“postcss-pxtorem”: “^5.1.1”,

运行起来，F12 元素 css 就是 vw 单位了

▲ 回顶部

✅ VantUI 组件按需加载

项目采

用Vant 自动按需引入组件 (推荐)下

面安装插件介绍：

babel-plugin-import 是一款 babel 插件，它会在编译过程中将

import 的写法自动转换为按需引入的方式

安装插件

npm i babel-plugin-import -D

在babel.config.js 设置

// 对于使用 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 下统一管理组件，用哪个引入哪个，无需在页面里重复引用

// 按需全局引入 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)

▲ 回顶部

✅ Sass 全局样式

首先 你可能会遇到 node-sass 安装不成功，别放弃多试几次！！！

每个页面自己对应的样式都写在自己的 .vue 文件之中 scoped 它顾名思义给 css 加了一个域的概念。

目录结构

vue-h5-template 所有全局样式都在 @/src/assets/css 目录下设置

├── assets

│ ├── css

│ │ ├── index.scss # 全局通用样式

│ │ ├── mixin.scss # 全局mixin

│ │ └── variables.scss # 全局变量

自定义 vant-ui 样式

现在我们来说说怎么重写 vant-ui 样式。由于 vant-ui 的样式我们是在全局引入的，所以你想在某个页面里面覆盖它的样式就不能

加 scoped，但你又想只覆盖这个页面的 vant 样式，你就可在它的父级加一个 class，用命名空间来解决问题。

.about-container {

/* 你的命名空间 */

.van-button {

/* vant-ui 元素*/

margin-right: 0px;

}

}

父组件改变子组件样式 深度选择器

当你子组件使用了 scoped 但在父组件又想修改子组件的样式可以 通过 >>> 来实现：

全局变量

vue.config.js 配置使用 css.loaderOptions 选项,注入 sass 的 mixin variables 到全局，不需要手动引入 ,配

置$cdn通过变量形式引入 cdn 地址,这样向所有 Sass/Less 样式传入共享的全局变量：

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访问

// 引入全局样式

import ‘@/assets/css/index.scss’

// 设置 js中可以访问 $cdn

// 引入cdn

import { $cdn } from ‘@/config’

Vue.prototype.$cdn = $cdn

在 css 和 js 使用

▲ 回顶部

✅ Vuex 状态管理

目录结构

├── store

│ ├── modules

│ │ └── app.js

│ ├── index.js

│ ├── getters.js

main.js 引入

import Vue from ‘vue’

import App from ‘./App.vue’

import store from ‘./store’

new Vue({

el: ‘#app’,

router,

store,

render: h => h(App)

})

使用

▲ 回顶部

✅ Vue-router

本案例采用 hash 模式，开发者根据需求修改 mode base

注意：如果你使用了 history 模式，vue.config.js 中的 publicPath 要做对应的修改

前往:vue.config.js 基础配置

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

▲ 回顶部

✅ Axios 封装及接口管理

utils/request.js 封装 axios ,开发者需要根据后台接口做修改。

• service.interceptors.request.use 里可以设置请求头，比如设置 token

• config.hideloading 是在 api 文件夹下的接口参数里设置，下文会讲

• service.interceptors.response.use 里可以对接口返回数据处理，比如 401 删除本地信息，重新登录

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 交互中有些接口不需要让用户感知

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 组件

})

}

如何调用

// 请求接口

import { getUserInfo } from ‘@/api/user.js’

const params = { user: ‘sunnie’ }

getUserInfo(params)

.then(() => {})

.catch(() => {})

▲ 回顶部

✅ Webpack 4 vue.config.js 基础配置

如果你的 Vue Router 模式是 hash

publicPath: ‘./’,

如果你的 Vue Router 模式是 history 这里的 publicPath 和你的 Vue Router base 保持一直

publicPath: ‘/app/’,

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

}

// …

}

}

▲ 回顶部

✅ 配置 alias 别名

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’))

}

}

▲ 回顶部

✅ 配置 proxy 跨域

如果你的项目需要跨域设置，你需要打来 vue.config.js proxy 注释 并且配置相应参数

!!!注意：你还需要将 src/config/env.development.js 里的 baseApi 设置成 ‘/’

module.exports = {

devServer: {

// …

proxy: {

//配置跨域

‘/api’: {

target: ‘https://test.xxx.com’, // 接口的域名

// ws: true, // 是否启用websockets

changOrigin: true, // 开启代理，在本地创建一个虚拟服务端

pathRewrite: {

‘^/api’: ‘/’

}

}

}

}

}

使用 例如: src/api/home.js

export function getUserInfo(params) {

return request({

url: ‘/api/userinfo’,

method: ‘post’,

data: qs.stringify(params)

})

}

▲ 回顶部

✅ 配置 打包分析

const BundleAnalyzerPlugin = require(‘webpack-bundle-analyzer’).BundleAnalyzerPlugin

module.exports = {

chainWebpack: config => {

// 打包分析

if (IS_PROD) {

config.plugin(‘webpack-report’).use(BundleAnalyzerPlugin, [

{

analyzerMode: ‘static’

}

])

}

}

}

npm run build

▲ 回顶部

✅ 配置 externals 引入 cdn 资源

这个版本 CDN 不再引入，我测试了一下使用引入 CDN 和不使用,不使用会比使用时间少。网上不少文章测试 CDN 速度块，这个开发者可

以实际测试一下。

另外项目中使用的是公共 CDN 不稳定，域名解析也是需要时间的（如果你要使用请尽量使用同一个域名）

因为页面每次遇到<script>标签都会停下来解析执行，所以应该尽可能减少<script>标签的数量 HTTP请求存在一定的开销，100K

的文件比 5 个 20K 的文件下载的更快，所以较少脚本数量也是很有必要的

暂时还没有研究放到自己的 cdn 服务器上。

const defaultSettings = require(‘./src/config/index.js’)

const name = defaultSettings.title || ‘vue mobile template’

const IS_PROD = [‘production’, ‘prod’].includes(process.env.NODE_ENV)

// externals

const externals = {

vue: ‘Vue’,

‘vue-router’: ‘VueRouter’,

vuex: ‘Vuex’,

vant: ‘vant’,

axios: ‘axios’

}

// CDN外链，会插入到index.html中

const cdn = {

// 开发环境

dev: {

css: [],

js: []

},

// 生产环境

build: {

css: [‘https://cdn.jsdelivr.net/npm/vant@2.4.7/lib/index.css’],

js: [

‘https://cdn.jsdelivr.net/npm/vue@2.6.11/dist/vue.min.js’,

‘https://cdn.jsdelivr.net/npm/vue-router@3.1.5/dist/vue-router.min.js’,

‘https://cdn.jsdelivr.net/npm/axios@0.19.2/dist/axios.min.js’,

‘https://cdn.jsdelivr.net/npm/vuex@3.1.2/dist/vuex.min.js’,

‘https://cdn.jsdelivr.net/npm/vant@2.4.7/lib/index.min.js’

]

}

}

module.exports = {

configureWebpack: config => {

config.name = name

// 为生产环境修改配置…

if (IS_PROD) {

// externals

config.externals = externals

}

},

chainWebpack: config => {

/**

• 添加CDN参数到htmlWebpackPlugin配置中

*/

config.plugin(‘html’).tap(args => {

if (IS_PROD) {

args[0].cdn = cdn.build

} else {

args[0].cdn = cdn.dev

}

return args

})

}

}

在 public/index.html 中添加

<% for (var i in

htmlWebpackPlugin.options.cdn&&htmlWebpackPlugin.options.cdn.css) { %>

<% } %>

<% for (var i in

htmlWebpackPlugin.options.cdn&&htmlWebpackPlugin.options.cdn.js) { %>

<% } %>

▲ 回顶部

✅ 去掉 console.log

保留了测试环境和本地环境的 console.log

npm i -D babel-plugin-transform-remove-console

在 babel.config.js 中配置

// 获取 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

}

▲ 回顶部

✅ splitChunks 单独打包第三方模块

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’)

})

}

}

▲ 回顶部

✅ 添加 IE 兼容

之前的方式 会报 @babel/polyfill is deprecated. Please, use required parts of core-js and

regenerator-runtime/runtime separately

@babel/polyfill 废弃，使用 core-js 和 regenerator-runtime

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
roups 下可以可以配置多个组，每个组根据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’)

})

}

}

▲ 回顶部

✅ 添加 IE 兼容

之前的方式 会报 @babel/polyfill is deprecated. Please, use required parts of core-js and

regenerator-runtime/runtime separately

@babel/polyfill 废弃，使用 core-js 和 regenerator-runtime

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

[外链图片转存中…(img-y0kdHQVk-1715658173034)]

[外链图片转存中…(img-rWDWfEc9-1715658173035)]

[外链图片转存中…(img-rwOrWNmC-1715658173035)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！