peixue-dev/Archive/[一次性]小程序主包优化方案-2026-01-31.md

128 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 小程序主包优化方案
## 当前状态
### 代码包大小
- **总大小**: 6MB
- **主包限制**: 2MB
- **问题**: 主包超过限制,无法上传
### 主包页面27个
当前主包包含太多页面,需要精简:
```
pages/index/index ✅ 保留(首页)
pages/service/list ✅ 保留Tab页
pages/search/index ✅ 保留(搜索)
pages/search/result ✅ 保留(搜索结果)
pages/promo/detail ❌ 移到 activity-package
pages/booking/quick-booking ✅ 保留Tab页
pages/order/list ✅ 保留Tab页
pages/user/index ✅ 保留Tab页
pages/user/setting ❌ 移到 user-package
pages/service/detail ✅ 保留(服务详情)
pages/teacher/detail ✅ 保留(教师详情)
pages/teacher/reviews ❌ 移到 teacher-package
pages/teacher/list ✅ 保留(选择陪伴员)
pages/message/chat ❌ 移到 common-package
pages/login/index ✅ 保留(登录)
pages/register/role-select ✅ 保留(注册)
pages/register/index ✅ 保留(注册)
pages/booking/teacher-booking ❌ 移到 order-package
pages/auth/role-select ✅ 保留(身份选择)
pages/auth/parent-register ✅ 保留(家长注册)
pages/auth/parent-quick-register ✅ 保留(快速注册)
pages/agreement/user ❌ 移到 common-package
pages/agreement/privacy ❌ 移到 common-package
pages/test/simple ❌ 删除(测试页面)
pages/payment/index ❌ 移到 order-package
pages/course/list ❌ 移到 activity-package
pages/course/detail ❌ 移到 activity-package
```
### 优化后主包页面13个
保留核心页面:
1. 首页
2. 5个Tab页首页、服务、快速预约、日历、我的
3. 登录/注册相关4个
4. 搜索相关2个
5. 服务详情
6. 教师详情
7. 教师列表
## 优化步骤
### 步骤1: 备份当前配置
```bash
copy peidu\uniapp\src\pages.json peidu\uniapp\src\pages.json.backup
```
### 步骤2: 修改 pages.json
将以下页面从主包移到对应分包:
#### 移到 user-package
- pages/user/setting
#### 移到 order-package
- pages/booking/teacher-booking
- pages/payment/index
#### 移到 activity-package
- pages/promo/detail
- pages/course/list
- pages/course/detail
#### 移到 common-package
- pages/message/chat
- pages/agreement/user
- pages/agreement/privacy
#### 移到 teacher-package
- pages/teacher/reviews
#### 删除
- pages/test/simple
### 步骤3: 更新页面跳转路径
所有跳转到移动页面的地方需要更新路径,例如:
```javascript
// 原来
uni.navigateTo({ url: '/pages/user/setting' })
// 修改后
uni.navigateTo({ url: '/user-package/pages/user/setting' })
```
### 步骤4: 重新编译测试
```bash
npm run dev:mp-weixin
```
## 预期效果
移动 14 个页面后,主包大小预计减少约 **1-1.5MB**,应该可以控制在 2MB 以内。
## 风险提示
1. **页面跳转失败**: 移动页面后,所有跳转路径都需要更新
2. **Tab页限制**: Tab页必须在主包中不能移动
3. **首次访问页面**: 首次访问的页面建议放主包,提升体验
## 建议
由于涉及大量页面路径修改,建议:
1. **先测试**: 在开发环境充分测试
2. **分步进行**: 先移动几个页面测试,确认无问题后再继续
3. **记录修改**: 记录所有修改的跳转路径,便于回滚
## 需要确认
是否需要我帮你执行这个优化方案?如果需要,我会:
1. 修改 pages.json
2. 搜索并更新所有相关的页面跳转路径
3. 重新编译测试