更新记录

1.0.0（2026-09-04） 下载此版本

开源企业级 UniApp 移动端基座正式发布。一套源码支持微信小程序 / H5 / App 新增内容： 1、三 Tab 基座：首页、消息、我的（原生 tabBar） 2、登录全套：账号密码、验证码登录、注册、找回密码；微信登录弹窗分流 3、消息中心：分类未读、列表与详情 4、我的：资料、改密、换绑手机、登录设备、手势密码、设置、账号注销申请 5、上架向能力：隐私协议弹窗、版本检测、空态与断网提示、Token 无感刷新 6、业务分包：demo（列表/表单模板等）、pay、map、ocr、ai、print 7、工程规范：强制主包瘦身与分包、统一样式令牌、主包体积检查脚本

平台兼容性

QKL-Boot 移动端（UniApp）

开源企业级前后端脚手架 · C 端移动基座
一套源码编译 微信小程序 / H5 / App · 强制分包 · 可对接完整 Java 后端与 Vue3 管理端

全套开源源码（Java + Admin + UniApp）：https://gitee.com/gzqkl/qkl-boot
维护：晴空蓝网络科技（Qingkonglan）· 协议：Apache 2.0

# 获取全套可编译源码（推荐，含后端与管理端）
git clone https://gitee.com/gzqkl/qkl-boot.git
cd qkl-boot

本页只介绍 UniApp 移动端。后端 qkl-boot-java、管理端 qkl-boot-admin 与移动端同仓开源，请克隆完整仓库，勿只拷贝移动端目录。

为什么选这套移动端脚手架？

面向要做 C 端小程序 / H5 / App 的团队：不是管理后台的「手机版」，而是独立消费者基座——登录态、消息、个人中心、支付 / AI / OCR / 地图等能力按分包落地，主包刻意做瘦，方便过审与长期迭代。

界面预览

更多截图（含管理端）：Gitee · docs/screenshots

整体框架一览（三仓）

微信小程序 / H5 / App（qkl-boot-uniapp）
        │  仅 /mobile/**
        ▼
   qkl-boot-java :8080          ◄── 管理端 Admin 仅 /admin/**
   Spring Boot 3.5 · JDK 17
        │
   MySQL 8 · Redis 7 · 对象存储

完整能力请从 Gitee 克隆 monorepo，契约按 /mobile 设计，不要只拷贝移动端硬连无关后端。

移动端已有能力

基座（主包）

• 三 Tab：首页 · 消息 · 我的（pages.json 原生 tabBar）
• 登录全套：账号密码、验证码登录、注册、找回密码；微信登录走底部弹窗分流
• 消息中心：分类未读、列表、详情；对接后端通知能力
• 我的：资料、改密、换绑手机、登录设备、手势密码、设置、账号注销申请等
• 公共能力：隐私协议、空态 / 断网提示、路由鉴权守卫、Token 无感刷新

业务分包（出厂）

首页快捷入口为固定能力清单（不依赖后台 MOBILE 菜单权限勾选），适合 C 端产品心智。

工程与规范

技术栈版本

配套后端建议：JDK 17 · Spring Boot 3.5.x · MySQL 8 · Redis 7。

快速开始

1. 克隆全套源码

git clone https://gitee.com/gzqkl/qkl-boot.git
cd qkl-boot

2. 启动后端（推荐）

cd qkl-boot-java
cp .env.example .env
docker compose up -d          # MySQL8 + Redis7
mvn -pl qkl-bootstrap -am spring-boot:run -s .mvn/settings.xml
# → http://localhost:8080

联调账号示例：user / user1234（以种子数据为准）。
更细联调说明见：三仓联调一页纸

3. 启动 UniApp

cd qkl-boot-uniapp
cp .env.development.example .env.development   # 按需改代理
pnpm install

pnpm dev:h5              # H5 → http://localhost:5174 ，代理 /mobile → 8080
pnpm dev:mp-weixin       # 微信开发者工具打开 dist/dev/mp-weixin

小程序正式环境请在 src/manifest.json → mp-weixin.appid 填写真实 AppID，并配置合法 request / socket 域名；VITE_WX_APP_ID 建议与后台「小程序绑定」一致。

目录结构（移动端）

qkl-boot-uniapp/
├── src/
│   ├── api/                 # 主包接口（auth / my / message / common / home）
│   ├── components/          # 全局组件（空态、断网、隐私弹窗等）
│   ├── composables/         # useRouter / useDebounceClick …
│   ├── pages/               # 主包：home · message · my · login · common
│   ├── stores/              # Pinia
│   ├── subpackages/         # 业务分包：demo · pay · map · ocr · ai · print
│   ├── utils/               # request · storage · 鉴权守卫 · 平台工具
│   ├── pages.json           # 原生 tabBar + subPackages + preloadRule
│   ├── manifest.json
│   └── uni.scss             # $qkl-* 设计令牌
├── .env.development.example
└── package.json

二开怎么加一个业务页？

1. 在 src/subpackages/ 新建 {你的业务域}/（含 pages、api，按需 components / static）
2. pages.json → subPackages 注册页面
3. 优先拷贝 subpackages/demo/pages/tplList / tplTabList / tplForm，把 mock 换成真实 /mobile/** 接口
4. 在首页能力入口挂上 path
5. 禁止：业务页塞进主包；主包 import 分包 api；混调 /admin/**

更多说明（均在 Gitee 全套仓库内）：

• 二次开发指南
• 功能介绍
• 根 README

适合谁？

• 要快速起 微信小程序 + H5 的业务团队
• 需要 后台可配（短信、支付、AI、文件存储）并与移动端联调的一体化方案
• 重视 主包体积、上架合规、可维护分包结构 的长期项目
• 用 Cursor 等 AI 工具 基于样板批量加页面的团队

不适合：只想要几个静态 Demo 页、不需要后端与权限体系的纯展示站。

开源与仓库

git clone https://gitee.com/gzqkl/qkl-boot.git
cd qkl-boot

欢迎 Star、Issue 与 PR。若本页对你有帮助，欢迎分享给正在选型 UniApp 企业脚手架的同学。

QKL-Boot：开源 · 无后门 · 自托管 · 可 AI 二开的企业级前后端脚手架。
全套源码 → https://gitee.com/gzqkl/qkl-boot