Uni-app项目本地运行与调试指南

技术栈说明

本项目采用以下技术栈：

• Uniapp：跨平台开发框架
• Vite：下一代前端构建工具
• Vue3：最新版Vue框架
• Tailwind CSS：实用优先的CSS框架

请确保使用匹配的依赖版本以保证项目正常运行。

环境准备

需要准备以下工具：

• TraeAPI：用于API调试，下载地址：https://www.trae.cn/
• HBuilder X：用于原生App调试，下载地址：https://hx.dcloud.net.cn/
• 微信开发者工具：用于小程序调试，从微信官方下载
• Node.js：运行环境，下载地址：https://nodejs.org/

推荐使用pnpm管理依赖，安装命令：npm install -g pnpm。

项目获取与依赖安装

1. Fork项目仓库到自己的账户。
2. 克隆仓库到本地。
3. 切换分支：根据需要选择master分支（纯净框架）或番茄小说模仿分支（完整实现）。

克隆后，进入项目目录，安装依赖：运行 pnpm install 或 npm install，首次安装可能需要1-3分钟。

微信小程序启动

1. 编译项目：运行构建命令，生成小程序代码。
2. 修改AppID：打开manifest.json文件，将微信小程序AppID修改为自己的开发者ID。AppID不匹配会导致初始化失败。
3. 导入项目：在微信开发者工具中导入编译后的dist/dev/mp-weixin目录。

HBuilder X真机调试

1. 手机准备：开启开发者模式（连续点击“设置 > 关于手机 > 版本号”），启用USB调试。
2. 编译项目：编译为App版本。
3. HBuilder操作：在HBuilder X中导入编译后的app目录，选择“运行 > 到手机或模拟器”。
4. 连接问题解决：若无法识别设备，尝试更换原装数据线、重新插拔USB连接，或检查手机弹窗授权提示。

调试技巧

• 小程序端使用微信开发者工具控制台进行调试。
• App端使用HBuilder控制台和Chrome调试工具。

根据需求选择分支进行开发，遇到问题时参考完整实现分支的代码。