使用VUE3.0版本搭建H5模板

使用VUE3.0版本搭建H5模板，开箱即用

小周sir的码农

3385人浏览 · 2022-11-19 08:00:00

小周sir的码农 · 2022-11-19 08:00:00 发布

使用VUE3.0版本搭建H5模板

仓库地址，有需要的可以参考参考 https://gitee.com/young_frivolous/vue3-app-template/tree/master
为了方便每次写项目都要去搭建一个框架，今天使用vue3.0从0开始实行一个开箱即用移动端模板，
基于vue3.0全家桶 + vant3.0 +scss + rem适配方案 + axios封装，构建H5模板脚手架

版本要求

vue cli版本需要node 15 或者更高的版本。或者你可以使用nvm来切换node版本
本次node采用版本是15.14.0

项目创建

确保电脑已经安装node和vue-cli环境
在命令窗口执行vue create my-app
提示会让你选择哪种方案，在这里选择Manually select features

360截图18481112206322.png

当执行完这一步的时候，下一步会提示Check the features needed for your project
在当前项目我们选择babel,Router,Vuex,CSS即可
下一步让我选择当前项目的版本。我们选择3.x

下一步让我选择路由的模式,选择Y即可
下一步，会让选择css预处理，默认选择第一个即可

下一步，会让选择格式配置，选择ESLint + Prettier

下一步会让选择保存代码格式化方式，选择第一个即可

=
下一步，提示配置项放在哪个位置
下一步提示，是否保存上面的记录
接下来就是等待项目创建

项目启动以及配置

项目安装完之后，进入当前项目，通过命令cnpm run serve启动项目即可

vue.config.js常见配置，项目然后重启即可

const { defineConfig } = require('@vue/cli-service');
const path = require('path');
const resolve = (dir) => path.join(__dirname, dir);
module.exports = defineConfig({
	transpileDependencies: true,
	publicPath: './', // 署应用包时的基本 URL。 vue-router hash 模式使用
	outputDir: 'dist', //  生产环境构建文件的目录
	assetsDir: 'static', //  outputDir的静态资源(js、css、img、fonts)目录
	lintOnSave: false, //eslint 检测
	productionSourceMap: false, // 如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建。
	devServer: {
		hot: true,
		port: 9527,
		headers: {
			'Access-Control-Allow-Origin': '*',
		},
	},
	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'));
	},
});

重置一些css样式，CSS地址放在自己项目中即可

安装`postcss-px-to-viewport`插件，项目采用px转vw形式

cnpm install postcss-px-to-viewport -S

需要在根目录新建postcss.config.js文件

module.exports = {
 plugins: {
  // to edit target browsers: use "browserslist" field in package.json
  autoprefixer: {}, //自动添加前缀
  "postcss-px-to-viewport": {
   unitToConvert: "px", //需要转换的单位，默认为"px"
   viewportWidth: 750, //设计稿的视口宽度，一般是375左右，iphone和很多安卓机等机型都差不多，ipad除外。如果是viewportWidth是375，font-size：14，那么font-size会转换为3.73333vm，计算过程：14÷375×100=3.73333
   unitPrecision: 5, //单位转换后保留的精度
   propList: ["*"], //能转化为vw的属性列表
   viewportUnit: "vw", //希望使用的视口单位
   fontViewportUnit: "vw", //字体使用的视口单位
   selectorBlackList: [], //需要忽略的CSS选择器，不会转为视口单位，使用原有的px等单位。
   minPixelValue: 1, //设置最小的转换数值，如果为1的话，只有大于1的值会被转换
   mediaQuery: false, //媒体查询里的单位是否需要转换单位
   replace: true, //是否直接更换属性值，而不添加备用属性
   exclude: undefined, //忽略某些文件夹下的文件或特定文件
   include: /Test.vue/, //如果设置了include，那将只有匹配到的文件才会被转换
   landscape: false, //是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
   landscapeUnit: "vw", //横屏时使用的单位
   landscapeWidth: 1338, //横屏时使用的视口宽度
  },
 },
};

配置代码格式化

首先安装 prettier
在根目录新建.prettierrc

{
  "printWidth": 120,
  "tabWidth": 2,
  "singleQuote": true,
  "trailingComma": "none",
  "semi": false,
  "wrap_line_length": 120,
  "wrap_attributes": "auto",
  "proseWrap": "always",
  "arrowParens": "avoid",
  "bracketSpacing": true,
  "jsxBracketSameLine": true,
  "useTabs": false,
  "eslintIntegration": true,
  "overrides": [
    {
      "files": ".prettierrc",
      "options": {
        "parser": "json"
      }
    }
  ],
  "endOfLine": "auto"
}

husky 是一个 Git Hook 工具。主要实现提交前 eslint 校验和 commit 信息的规范校验，也可以避免多人合作时代码格式化不统一造成的冲突；
安装husky和lint-staged
需要在package.json配置

"husky": {
    "hooks": {
      "pre-commit": "lint-staged --allow-empty"
    }
  },
  "lint-staged": {
    "src/**/*.{js,vue,html,json}": [
      "vue-cli-service lint"
    ]
  }

配置多环境变量

根据npm run build:xxx打包不通环境包

  "scripts": {
    "serve": "vue-cli-service serve",
    "build": "vue-cli-service build --mode development",
    "build:stage": "vue-cli-service build --mode staging",
    "build:prod": "vue-cli-service build --mode production",
    "lint": "vue-cli-service lint"
  },

配置文件
在根目录新建.env.development 开发环境

NODE_ENV=development
VUE_APP_BASE_URL=http://jsonplaceholder.typicode.com

在根目录新建.env.production 生产环境

NODE_ENV=production
VUE_APP_BASE_URL=http://jsonplaceholder.typicode.com

在根目录新建.env.staging 预发布环境

NODE_ENV=staging
VUE_APP_BASE_URL=http://jsonplaceholder.typicode.com

配置请求拦截

为了统一请求拦截，使用axios统一处理
首先在本地安装axios请求库

import axios from 'axios'
const service = axios.create({
  baseURL: process.env.VUE_APP_BASE_URL,
  withCredentials: false,
  timeout: 5000
})

// request拦截器 request interceptor
service.interceptors.request.use(
  config => {
    let token = 'xxxx'
    if (token) {
      config.headers['Authorization'] = 'Bearer ' + token
    }
    return config
  },
  error => {
    console.log(error)
    return Promise.reject(error)
  }
)

// respone拦截器
service.interceptors.response.use(
  response => {
    const res = response.data
    if (response.status && response.status !== 200) {
      return Promise.reject(res)
    } else {
      return Promise.resolve(res)
    }
  },
  error => {
    return Promise.reject(error)
  }
)
export default service

接口统一管理

在src/api 文件夹下统一管理接口
你可以建立多个模块对接接口, 比如 home.js 里是首页的接口这里讲解 getUser.js

import request from '@/util/request.js'

export function getUser(params) {
  return request({
    url: '/posts',
    method: 'get',
    params
  })
}

接口使用方式，在vue组件中使用

import { getUser } from '@/api/home'

const params = { user: 'sunnie' }
getUser(params).then((res) => {
  
}).catch((error)=>{})

项目中使用vant

首先安装cnpm i vant -S

我们通过按需引入方式,然后在页面中直接使用即可，需要哪个组件，引入哪个组件

import { Button } from 'vant'
import 'vant/lib/index.css'

let app = createApp(App)
app.use(Button)

安装手机端调试工具

在手机通过vconsole也可以和PC端控制台打印日志
首先安装 cnpm install vconsole -S
在main.js引入

import * as vConsole from 'vconsole'
// 手机端控制台
if (process.env.NODE_ENV !== 'production') {
  new vConsole()
}

以上就是H5模板流程搭建，自己也可以尝试更加完善

Vue

前往低代码交流专区

更多推荐

vue 表单验证

1、6位小写字母和数字必须包含两个字母rules: [{ required: true, message: "XXX不能为空", trigger: "blur" },{ max: 6, message: "最大长度为6位字符", trigger: "blur" },{pattern: /^(?=(?:[^a-z]*[a-z]){2})[a-z0-9]{6,6}$/, //不连续的两位字母// /^