peixue-dev/peidu/Archive/一次性文件/[一次性]编译修复总结-2026-01-26.md

UniApp 项目编译修复总结 - 2026-01-26

问题描述

HBuilder X 编译时报错，提示找不到多个模块文件。

根本原因

项目使用了双目录结构：

• src/ 目录：源代码目录
• 根目录：编译时需要的文件

编译器在根目录查找文件，但实际文件在 src/ 目录下。

修复步骤

1. 修复 pages.json 配置

删除了 26 个不存在的页面配置：

• user-package: 4 个页面
• teacher-package: 7 个页面
• provider-package: 10 个页面
• training-package: 4 个页面
• activity-package: 1 个页面

工具： [一次性]fix-pages-json.py

2. 复制缺失的文件

从 src/ 目录复制到根目录：

API 文件 (16个)

• calendar.js
• export.js
• franchise.js
• groupBuyApi.js
• growthRecord.js
• index.js
• managerApplication.js
• notification.js
• operationLog.js
• permission.js
• provider.js
• recordApi.js
• reminder.js
• review.js
• teacherLevel.js
• tenant.js

Utils 文件 (10个)

• dataHelper.js
• dataParser.js
• datetime.js
• imageHelper.js
• messagePolling.js
• money.js
• navigation.js
• params.js
• request.js
• upload.js

Config 文件 (1个)

• map.js

Mixins 文件 (2个)

• orderStatusPolling.js
• providerAuth.js

Store 文件 (2个)

• index.js
• user.js

Components 目录

• 递归复制整个 components 目录及其子文件夹

工具： [一次性]copy-missing-files.py

编译状态

✅ 已修复的问题：

1. pages.json 配置错误
2. recordApi.js 缺失
3. params.js 缺失
4. money.js 等 utils 文件缺失
5. map.js 配置文件缺失
6. components/calendar/calendar.vue 缺失

下一步

在 HBuilder X 中重新编译项目，应该可以成功打包。

使用的脚本文件

1. [一次性]fix-pages-json.py - 修复 pages.json
2. [一次性]copy-missing-files.py - 批量复制文件

这些脚本已归档到 peidu/Archive/一次性文件/ 目录。