效果图

项目的创建和组件库的安装

1. 项目创建

pnpm create vite vue3-vant4-vite-pinia-pro-h5

注意： node版本控制在 18+， 可以通过nvm来管理本地的node版本，具体可以看这篇文章 nvm的简单使用

2. vant-ui库的安装【这里安装的是 ^4.6.0 版本的】

pnpm add vant

注意: 具体的一些配置这里就不介绍了，可以去 vant-ui官网 查看详细的安装和配置

项目目录预览

就按上面的项目目录 对主要的文件就行简单说明。

1. api 文件目录 【存放项目中所有的接口】

import request from "@/utils/request";// banner 列表
export const getBannerList = (params) => request.get(`/goodsBanner/list`, { params });
// 菜单列表
export const getMenuList = (params) => request.get(`/homeMenu/getList`, { params });

2. assets 文件目录【存放项目中的一些静态文件: icon、svg等】
3. components 文件目录【存放项目中的组件】
   

简要说明：
globalComponents ： 全局组件，已经全局注册 【页面使用不需要引入】（一般很常用的组件放这里）
localComponents ： 本地组件， 没有全局注册 【页面使用需要手动引入】（一般不常用的可以放这里）
registerGlobComp： 组件注册文件，注册全局组件和vant-ui组件【vant-ui组件我这里用的是按需引入，需要手动引入】，如何想全局引入vant-ui组件，可以去 vant-ui官网 查看

4. directives文件目录【存放自定义的vue指定】，以下是一个自定义的旋转指令（v-rotate）

• 代码

const rotateDirective = {/*** mounted 钩子函数，在绑定元素的父组件及他自己的所有子节点都挂载完成后调用* el: 指令绑定到的元素。这可以用于直接操作 DOM。* value: 传给指令的值，也就是我们要 copy 的值*/mounted(el, { value }) {// console.log("value==:", value, typeof value);el.$value = value; // 用一个全局属性来存传进来的值，因为这个值在别的钩子函数里还会用到// el.className = 'v-rotate'el.classList.add("v-rotate");if (typeof value === "undefined") return;el.style.display = value ? "block" : "none";},// 在绑定元素的父组件及他自己的所有子节点都更新后调用updated(el, { value }) {// console.log("更新触发", value);if (typeof value === "undefined") return;el.style.display = value ? "block" : "none";},// 指令与元素解绑后，移除事件绑定unmounted(el) {el.classList.remove("v-rotate");},
};export function setupRotateDirective(app) {app.directive("rotate", rotateDirective);
}export default rotateDirective;

• 具体使用 【可以去本项目的 src/views/mine/index.vue 文件查看】

 <SvgIcon v-rotate icon-class="loading" />

5. hooks文件目录 【钩子函数】，以下是封装的是一个loading 钩子

• 代码

import { showLoadingToast } from "vant";
import { onBeforeUnmount } from "vue";export function useLoading() {let toast = null;const startLoading = () => {toast = showLoadingToast({duration: 0,forbidClick: true,message: "加载中...",overlay: true,});};const stopLoading = () => {toast && toast.close();};onBeforeUnmount(stopLoading);return { startLoading, stopLoading };
}

• 具体使用 【可以去本项目的 src/views/index/index.vue 文件查看】

// 引入
import { useLoading } from '@/hooks/useLoading'
// 导出
const { startLoading, stopLoading } = useLoading()//  接口调用startLoading()getBannerList().then((res) => {stopLoading()console.log("数据：", res);const list = res.result || [];list.map((v) => (v.url = v.url.includes("http") ? v.url : `http://${v.url}`));bannerList.value = list;});

6. router 文件目录 【存放页面的路由】
7. store 文件目录【这里是项目的全局存储-用的pinia】

import { createPinia, defineStore } from "pinia";
// 引入持久化插件
import piniaPluginPersistedstate from "pinia-plugin-persistedstate";
// 实例化pinia
export const store = createPinia();
// 使用持久化存储插件
store.use(piniaPluginPersistedstate);// 系统统一存储
export const useAppStore = defineStore("app", {state: () => ({appName: "我是app名称",}),actions: {// 设置app名称setAppName(data) {this.appName = data;},},persist: {storage: localStorage, //default localStorage},
});

8. styles 文件目录【这里存放的项目中一些初始化css样式、组件库统一css样式修改、全局css变量等样式】
9. utils 文件目录 【存放一写工具函数：request.js 请求封装、wxJssdkTools.js 微信jssdk封装等】
10. views 文件目录【存放页面的文件】
11. .env .env.development .env.production 【三个项目配置文件：主要用于全局的配置，以及打包环境的配置】
12. postcss.config.cjs 文件【PostCSS 示例配置】
13. README.md 文件 【项目搭建过程中一些常用组件、方法的简单说明和使用】
14. vite.config.js 文件【vite的一些相关配置】

源码地址和下载

代码仓库地址： Gitee | Github 或者直接复制下面的链接 直接下载代码

• Gitee 远程仓库下载链接

https://gitee.com/junfeng535/vue3-vant4-vite-pinia-pro-h5.git

• Github 远程仓库下载链接

https://github.com/junfeng-git/vue3-vant4-vite-pinia-pro-h5.git

其他一些页面截图