# baseUniapp

**Repository Path**: qssily/base-uniapp

## Basic Information

- **Project Name**: baseUniapp
- **Description**: 基于 UniApp + TS + Vue3 + Vite 创建的 uni-app 基础项目，可用于快速搭建uniapp项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-01
- **Last Updated**: 2025-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: uni-app, TypeScript, Vue

## README

## 1.0 版本! 🎉🎉🎉
2025-08-05 更新

本项目适用于vscode开发，HBuilderX使用状况未知(未测试)

基于 UniApp + TS + Vue3 + Vite + Pinia 创建的 uni-app 基础项目，可用于快速搭建uniapp项目  

使用UI： [Wot UI](https://wot-design-uni.cn/)  

基础项目：uni-preset-vue  



## 使用

### 安装

使用 npx 创建项目(请忽略)：

```shell
$ npx degit dcloudio/uni-preset-vue#vite-ts 项目名称
```

克隆项目到本地(自行修改项目名)：

```shell
$ git clone https://gitee.com/qssily/base-uniapp.git 项目名称
$ cd 项目名称
```

初始化项目:

```shell
$ npm install
$ git init
```

安装依赖(已安装，请忽略):

```shell
$ npm i wot-design-uni 
$ npm i pinia 
$ npm i pinia-plugin-persistedstate
```

运行项目：

```shell
$ npm run dev:mp-weixin
```

上线项目：

```shell
$ npm run build:mp-weixin
```
## 注意事项

1. 初始化项目安装的typescript版本过低，已重新安装最新版;
2. （本项目已修改）uniapp关于ts选项‘importsNotUsedAsValues‘和‘preserveValueImports‘弃用改用“verbatimModuleSyntax”问题，在"@vue/tsconfig/tsconfig.json"文件中注释掉相关选项，再在tsconfig.json中添加verbatimModuleSyntax的配置;
3. 记得修改manifest.json文件，将appid替换成自己的appid;
4. 关于使用的UI库为wot-design-uni，使用的是npm的方法安装，故如果想卸载：请使用npm uninstall wot-design-uni 和 npm uninstall sass 即可, 并可以将pages.json文件的 easycom 字段删除;
5. 项目使用了pinia状态管理，附带使用了使用持久化存储插件pinia-plugin-persistedstate，如不需要可以卸载pinia和插件，并删除stores/下文件;
6. 注意vue3、vite、pinia、ts各版本之间的兼容问题，遇到问题可根据报错提示安装对应版本;