项目结构

miniprogram/
├── app.js                     # 应用入口和全局生命周期
├── app.json                   # 页面、窗口、tabBar、分包等全局配置
├── app.wxss                   # 全局样式
├── pages/
│   └── home/
│       ├── index.js           # Page 逻辑
│       ├── index.json         # 页面配置与组件注册
│       ├── index.wxml         # 模板
│       └── index.wxss         # 页面样式
├── components/                # 可复用自定义组件
├── services/                  # 请求、鉴权、业务服务
├── utils/                     # 无副作用工具函数
├── static/                    # 静态资源
├── subpackages/               # 分包页面与资源
└── sitemap.json               # 搜索索引配置（可选）

根目录还包含 project.config.json（项目与开发者工具配置）及 project.private.config.json（个人配置）。app.js、app.json、app.wxss 是应用主体文件；页面至少需要 .js 与 .wxml。

分层约定

• pages：页面编排和展示状态，不直接堆积网络、鉴权或复杂转换逻辑。
• components：通过 properties 接收输入、通过事件通知外部，避免读写页面私有状态。
• services：封装请求、登录态、埋点等跨页面能力。
• utils：保持纯函数和可测试，不调用页面实例。

页面路径以 app.json 注册为准。主包只放启动必需内容；低频功能放入分包。