2.7 常见问题解决

在 AI 编程过程中遇到问题是正常的。掌握常见问题的解决方法，能让你更高效地与 AI 协作。

技术问题解决

问题 1：AI 生成的代码有错误

解决步骤：

1. 收集完整信息

   我遇到了以下错误：
   
   错误信息：[粘贴完整错误信息]
   相关代码：[粘贴相关代码]
   期望行为：[描述你期望的结果]
   实际行为：[描述实际发生的情况]
   
   请帮我分析问题原因并提供修复方案。

2. 提供更多上下文

   这个组件是用在以下场景中的：
   - 项目技术栈：React + TypeScript + Tailwind
   - 组件用途：[说明组件的用途]
   - 数据流向：[说明数据如何传递]
   
   错误出现时的操作步骤：
   1. [操作1]
   2. [操作2]
   3. [错误出现]

问题 2：AI 不理解复杂需求

解决策略：

1. 分解复杂需求

   原需求：创建一个完整的电商系统
   
   分解后：
   1. 先创建商品展示页面
   2. 添加购物车功能
   3. 实现用户认证
   4. 添加支付功能

2. 使用类比和示例

   请参考这个已知的组件结构，帮我创建类似的功能：
   
   已知组件：[粘贴参考代码]
   
   需要创建：[描述新功能]
   相似之处：[说明相似点]
   不同之处：[说明不同点]

问题 3：性能问题

诊断和解决：

我的页面/组件性能很差，请帮我优化：

性能问题：
- 页面加载时间：[具体时间]
- 主要问题表现：[描述具体问题]
- 影响的功能：[哪些功能受影响]

技术环境：
- React 版本：[版本号]
- 数据量：[数据规模]
- 复杂度：[组件复杂度]

请提供：
1. 性能瓶颈分析
2. 具体优化方案
3. 代码实现
4. 性能改进预期

沟通问题解决

问题 1：AI 回答不够详细

改进提问方式：

❌ 原问法：如何实现登录功能？

✅ 改进问法：
你是一位全栈开发专家，请帮我设计一个完整的用户认证系统：

需求详情：
1. 用户注册（邮箱验证）
2. 用户登录（记住登录状态）
3. 密码重置
4. 社交媒体登录（Google、GitHub）

技术要求：
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：MongoDB
- 认证：JWT

请提供：
1. 完整的实现方案
2. 数据库设计
3. 前后端代码
4. 安全考虑
5. 错误处理

问题 2：AI 生成不符合预期的代码

引导方法：

1. 提供具体示例

   我想要的效果是这样的：
   
   期望的代码结构：
   ```tsx
   // 这是我想要的代码结构示例
   function MyComponent() {
     // 期望的实现方式
   }

   请按照这个模式帮我实现：[你的需求]

2. 明确约束条件

   请帮我实现 [功能]，但要遵守以下规则：
   - 不要使用 [禁用的方法]
   - 必须使用 [必需的方法]
   - 代码风格要符合 [风格要求]
   - 考虑 [特殊场景]

问题 3：对话上下文丢失

解决方案：

1. 定期总结上下文

   请帮我梳理一下当前的项目状态：
   
   已完成的功能：
   - [功能1]
   - [功能2]
   
   当前要解决的问题：
   - [当前问题]
   
   技术栈和环境：
   - [技术栈信息]
   
   基于以上信息，请帮我解决：[新的问题]

2. 使用项目文档

   我的项目背景信息：
   
   项目类型：[项目类型]
   目标用户：[用户群体]
   主要功能：[核心功能]
   
   技术规范：
   - 编码标准：[标准描述]
   - 组件结构：[结构要求]
   
   请基于这些信息帮我：[具体需求]

质量问题解决

问题 1：代码质量不佳

质量提升策略：

请帮我重构这段代码，提升代码质量：

当前代码问题：
- 可读性差
- 缺少注释
- 性能问题
- 潜在的 bug

重构要求：
1. 添加详细的 TypeScript 类型定义
2. 增加代码注释和文档
3. 优化性能（避免不必要的渲染）
4. 添加错误处理和边界情况
5. 遵循最佳实践和设计模式

请提供：
1. 重构后的代码
2. 重构说明（为什么这样改）
3. 性能改进点
4. 可维护性提升

问题 2：安全性考虑不足

安全强化方法：

请帮我审查和加强这段代码的安全性：

安全要求：
- 输入验证和清理
- XSS 防护
- CSRF 防护
- SQL 注入防护
- 权限验证
- 敏感数据保护

请提供：
1. 安全风险评估
2. 具体的安全改进方案
3. 安全代码实现
4. 安全测试建议

工具特定问题

Cursor 常见问题

问题 1：AI 响应慢

• 检查网络连接
• 减少对话上下文长度
• 使用更具体的提问
• 重启 Cursor 应用

问题 2：生成代码不符合项目规范

• 创建和配置 .cursorrules 文件
• 在对话中明确提醒 AI 遵循规范
• 提供代码示例供 AI 参考

Trae 常见问题

问题 1：中文理解偏差

• 使用更简单的中文表达
• 提供英文关键词辅助
• 分步骤描述复杂需求

问题 2：Solo 模式效果不佳

• 提供更详细的项目描述
• 明确技术约束和要求
• 分阶段使用 Solo 模式

预防性措施

1. 建立 AI 编程规范

2. 使用项目模板

模板包含：

• 项目结构
• 配置文件
• 代码示例
• 最佳实践指南

3. 定期代码审查

审查清单：

• 功能正确性
• 代码质量
• 性能表现
• 安全性
• 可维护性
• 文档完整性

问题解决流程

标准解决流程

1. 问题定位

   • 确定问题的性质和范围
   • 分析问题的根本原因
   • 评估问题的影响程度

2. 信息收集

   • 收集错误信息和日志
   • 准备相关代码和上下文
   • 整理期望结果和实际表现

3. AI 沟通

   • 使用结构化的提问方式
   • 提供充分的上下文信息
   • 明确指定期望的输出格式

4. 方案验证

   • 测试 AI 提供的解决方案
   • 验证是否解决了原问题
   • 检查是否引入新的问题

5. 问题解决

   • 应用修复方案
   • 更新相关文档
   • 总结经验教训

紧急问题处理

快速响应策略：

1. 简化问题描述，抓住核心要点
2. 使用具体的错误信息和代码片段
3. 请求 AI 提供临时解决方案
4. 同时寻找备选解决方案

学习和改进

问题记录和分析

记录模板：

问题描述：
- 问题现象
- 出现时间
- 影响范围

解决过程：
- 尝试的方法
- 有效的方案
- 最终结果

经验总结：
- 问题根本原因
- 预防措施
- 相关知识点

技能提升方向

1. 沟通技巧：学习如何更准确地表达技术需求
2. 代码审查：提升发现和修复代码问题的能力
3. 系统思维：培养从整体角度分析和解决问题的能力
4. 工具熟练度：深入掌握 AI 编程工具的高级功能

下一步：掌握了问题解决技巧后，学习 最佳实践与技巧，进一步提升 AI 编程的效率和质量。