# uni-v3-vite-ts-template

**Repository Path**: huxley-w/uni-v3-vite-ts-template

## Basic Information

- **Project Name**: uni-v3-vite-ts-template
- **Description**: uniapp 开发模板（ts版）
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: template
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-03-19
- **Last Updated**: 2025-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: VSCode, uni-app, vue3, vite, TypeScript

## README

## 技术栈

- 编辑器推荐：Visual Studio Code
- 包管理器推荐：pnpm
- node 版本：>= v20

* 前端框架：[uni-app](https://uniapp.dcloud.net.cn/) (Vue3 <script setup>)

* 状态管理：[pinia](https://pinia.vuejs.org/zh/)

  > 注意：vue3 + pinia 运行会报错：hasInjectionContext‘ is not exported
  >
  > 解决方法：将 pinia 的版本进行降级，目前版本将为 2.0.36

* 组件库：[uni-ui](https://uniapp.dcloud.net.cn/component/uniui/uni-ui.html)

* 日期格式化：[dayjs](https://dayjs.fenxianglu.cn/)

* 规约化：eslint + prettier

## 运行程序

1. 安装依赖

```shell
# npm
npm i --registry=https://registry.npmmirror.com

# pnpm（推荐）
pnpm i --registry=https://registry.npmmirror.com
```

2. 运行程序

```shell
# 微信小程序端
pnpm run dev:mp-weixin

# H5端
pnpm run dev:h5

# App端
需 HbuilderX 工具，运行 - 运行到手机或模拟器
```

3. 微信开发者工具导入 `/dist/dev/mp-weixin` 目录

## 工程结构解析

```
├── .husky                     # Git Hooks
├── .vscode                    # VS Code 插件 + 设置
├── dist                       # 打包文件夹（可删除重新打包）
├── src                        # 源代码
│   ├── config                 # 公共配置(请求基地址)
│   ├── components             # 全局组件
│   ├── hooks                  # hook 函数
│   ├── pages                  # 主包页面
│       ├── index               # 首页
│       ├── category            # 分类页
│       ├── cart                # 购物车
│       ├── my                  # 我的
│       └── login               # 登录页
│   ├── services               # 所有请求
│   ├── static                 # 存放应用引用的本地静态资源的目录
│       ├── images              # 普通图片
│       └── tabs                # tabBar 图片
│   ├── stores                 # 全局 pinia store
│       ├── modules             # 模块
│       └── index.ts            # store 入口
│   ├── types                  # 类型定义
│       ├── modules             # 模块
│       └── index.ts            # 统一导出类型
│   ├── styles                 # 全局样式
│   ├── utils                  # 全局方法
│   ├── App.vue                # 入口页面
│   ├── main.ts                # Vue初始化入口文件
│   ├── pages.json             # 配置页面路由等页面类信息
│   ├── manifest.json          # 配置appid等打包信息
│   └── uni.scss               # uni-app 内置的常用样式变量
├── .editorconfig              # editorconfig 配置
├── .eslintrc.cjs              # eslint 配置
├── .prettierrc.json           # prettier 配置
├── .gitignore                 # git 忽略文件
├── index.html                 # H5 端首页
├── package.json               # package.json 依赖
└── vite.config.ts             # vite 配置
```



## 其他

因为项目中使用了 git + husky ,不合法的代码无法提交。如果想快速提交，则执行以下命令

```shell
git commit --no-verify -m 'feat'
```