#33. 常见问题

---

#项目理解偏差

症状：AI 对项目结构或技术栈的理解与实际不符

解决方案：

1. 检查项目是否完成索引（底部状态栏）
2. 完善 .cursorrules 文件，明确技术栈和规范
3. 在对话中使用 @ 精确指定上下文文件
4. 检查 .cursorignore 是否误排除了重要文件

#改动结果失真

症状：AI 的代码改动不符合预期，或改了不该改的地方

解决方案：

1. 使用更具体的指令，明确范围和约束
2. 开启 Plan Mode，先审查方案再执行
3. 将大任务拆分为小步骤
4. 撤销后重新表述指令

#补全质量波动

症状：Tab 补全时灵时不灵

解决方案：

1. 确保相关文件在编辑器中打开（Tab 模型会参考打开的文件）
2. 添加注释或类型注解帮助 Tab 模型理解意图
3. 检查网络连接是否稳定
4. 重启 Cursor 清除可能的缓存问题

#上下文丢失

症状：长对话中 AI "忘记"之前讨论的内容

解决方案：

1. 开始新对话，在首条消息中总结关键上下文
2. 使用 @ 引用相关文件，不依赖对话记忆
3. 将重要约定写入 .cursorrules，而非仅在对话中提及

#代码不可运行

症状：AI 生成的代码无法编译或运行

解决方案：

1. 让 Agent 运行测试和构建命令来验证
2. 在指令中要求 AI 运行 npm run build / tsc 验证
3. 提供完整的错误信息让 AI 修复
4. 检查 AI 是否引入了与项目版本不兼容的 API