返回 AI 教程
AI 入门指南

AI 编程实战:定位一个搜索功能错误

用复现步骤、最小修改和边界测试,让 AI 协助排查代码问题。

姑大姑爷的AI导航

这篇教程能帮你完成什么

以工具库的名称搜索为例:输入 DeepSeek 能找到结果,输入 deepseek 却找不到。我们希望搜索忽略大小写,同时不破坏已有的分类和价格筛选。完成后,你会得到一份可复现的问题记录、一处经过审查的修改和一组验证结果。

下面是演示场景。不同项目可能由数据库、搜索服务或浏览器负责筛选,应以项目真实代码和运行结果为准。

1. 记录现象,缩小范围

在提问前记录:页面地址或功能入口、输入内容、预期结果、实际结果、出现问题的环境,以及每次能否稳定复现。比如:

项目示例记录
操作进入工具列表,分别搜索 DeepSeek 和 deepseek
预期两种写法都能找到名称为 DeepSeek 的工具
实际第一种有结果,第二种无结果
其他条件使用同一分类和价格筛选,确认搜索词以外的条件一致

先排除输入前后空格、数据不存在或其他筛选条件的影响。日志和代码片段先脱敏;密码、访问令牌、生产数据、客户信息不要发给外部助手。

2. 把问题和约束交给 AI

使用 Cursor、GitHub Copilot 或其他编程助手,提供与搜索有关的最小代码片段、运行环境和已有测试命令。可以复制下面的模板,并把方括号中的内容换成实际情况:

项目技术栈:[填写语言、框架和数据库]
复现步骤:进入工具列表,搜索 DeepSeek 有结果,搜索 deepseek 没有结果。
预期行为:搜索工具名称时不区分英文字母大小写。
相关代码:[粘贴脱敏后的搜索入口和查询逻辑]
约束:保留分类和价格筛选;不修改数据结构;不引入新依赖。
请先判断搜索在哪一层执行、列出可能原因和验证方法,
然后提出最小修改,并说明空值和性能方面需要检查什么。

先让助手解释思路,再决定是否采用。它无法从一段代码自动知道线上实际部署、数据分布或权限设置;不确定的地方应标明并继续查证。

3. 审查修改,而不是直接接受

确认改动落在实际执行搜索的位置,并检查是否改变了其他条件的组合关系。例如,名称匹配与分类筛选原先同时生效,修复后仍应同时生效。如果项目使用数据库查询,核查大小写处理方式是否适合当前数据库及字段;如果是客户端筛选,要确认服务端分页不会让结果遗漏。

查看代码差异时,重点检查无关文件、异常处理、空值和潜在性能影响。不要为了一个搜索问题顺手改动登录、数据库配置或依赖版本。

4. 运行验证并记录结果

使用项目现有的测试和类型检查命令,再回到页面复测。至少覆盖:

  1. DeepSeek、deepseek 和大小写混合写法都能找到目标。
  2. 空搜索、前后空格、中文关键词和不存在的关键词行为符合需求。
  3. 搜索与分类、价格筛选组合时仍然正确。
  4. 清空搜索后列表和分页恢复正常,没有新的报错。

若项目缺少自动测试,可先用表格记录每次输入和结果,再按项目实际情况补充有意义的测试。将新的报错和脱敏后的复现步骤交给助手继续排查;发布前由开发者确认差异、验证结果和回滚方式。

下一步练习

将需求改成“搜索词前后有空格也能匹配”,重复上述过程。先写清预期,再检查空白搜索、纯空格输入和已有筛选是否受影响。

延伸阅读

版权所有 © 2026
保留所有权利