# 故障排查指南

## 问题：Failed to resolve import "vue"

### 解决方案

1. **确保依赖已安装**
   ```bash
   cd frontend
   npm install vue pinia
   ```

2. **清除缓存并重新安装**
   ```bash
   cd frontend
   npm cache clean --force
   rm -rf node_modules
   npm install
   ```

3. **在HBuilderX中运行**
   - 不要使用命令行运行
   - 直接在HBuilderX中：运行 → 运行到浏览器
   - HBuilderX会自动处理依赖

4. **检查node_modules**
   - 确保 `frontend/node_modules/vue` 目录存在
   - 如果不存在，执行 `npm install vue`

5. **如果仍然报错**
   - 尝试删除 `vite.config.js`（HBuilderX项目可能不需要）
   - 或者简化 `vite.config.js` 配置

## 常见问题

### Q: HBuilderX提示缺少index.html？
A: 已创建 `index.html` 文件，如果还有问题，检查文件是否在根目录。

### Q: 依赖安装失败？
A: 对于HBuilderX项目，通常不需要手动安装uni-app相关依赖，只需要安装业务依赖（vue、pinia）。

### Q: API请求失败？
A: 确保后端服务已启动，检查 `utils/request.js` 中的API地址配置。