概览
本章文档只覆盖移动端(uniapp/,UniApp),不包含管理后台(admin/)与 PC 端(pc/)。
技术栈
| 技术 | 用途 |
|---|---|
| UniApp + Vue 3 + TypeScript | 多端页面与类型 |
| uview-plus | UI 组件库(easycom 自动引入) |
| Pinia | 状态管理 |
| UnoCSS | 原子化样式 |
| Vue I18n | 多语言 |
同一套源码可编译到 H5、微信小程序、APP(见 manifest.json 的 h5 / mp-weixin / app-plus)。
开发
bash
cd uniapp
pnpm install
pnpm dev:h5
pnpm dev:mp-weixin命令以 uniapp/package.json 为准。H5 开发时 Vite 把 /api、/storage、/static 代理到 http://localhost:8005(uniapp/vite.config.ts)。请先启动后端,再开移动端。
H5 路由基座为 /mobile/(manifest.json → h5.router.base)。
目录速览
uniapp/src/
├── api/ # 用户端接口封装
├── components/ # 公共组件(d-*)与装修 / TabBar
├── hooks/ # Composables
├── modules/ # 业务分包(登录、用户、支付等)
├── pages/ # 主包 Tab 页与装修页
├── store/ # Pinia stores
└── utils/ # 请求、鉴权、平台判断、微信 OAuth 等主包 Tab:首页、发现、消息、我的;业务页放在 modules/ 分包,由 pages.json 声明。
后续篇章依次说明快速开始、内置模块、自定义组件、支付集成与微信登录。