这篇教程能帮你完成什么
以工具库的名称搜索为例:输入 DeepSeek 能找到结果,输入 deepseek 却找不到。我们希望搜索忽略大小写,同时不破坏已有的分类和价格筛选。完成后,你会得到一份可复现的问题记录、一处经过审查的修改和一组验证结果。
下面是演示场景。不同项目可能由数据库、搜索服务或浏览器负责筛选,应以项目真实代码和运行结果为准。
1. 记录现象,缩小范围
在提问前记录:页面地址或功能入口、输入内容、预期结果、实际结果、出现问题的环境,以及每次能否稳定复现。比如:
| 项目 | 示例记录 |
|---|---|
| 操作 | 进入工具列表,分别搜索 DeepSeek 和 deepseek |
| 预期 | 两种写法都能找到名称为 DeepSeek 的工具 |
| 实际 | 第一种有结果,第二种无结果 |
| 其他条件 | 使用同一分类和价格筛选,确认搜索词以外的条件一致 |
先排除输入前后空格、数据不存在或其他筛选条件的影响。日志和代码片段先脱敏;密码、访问令牌、生产数据、客户信息不要发给外部助手。
2. 把问题和约束交给 AI
使用 Cursor、GitHub Copilot 或其他编程助手,提供与搜索有关的最小代码片段、运行环境和已有测试命令。可以复制下面的模板,并把方括号中的内容换成实际情况:
项目技术栈:[填写语言、框架和数据库]
复现步骤:进入工具列表,搜索 DeepSeek 有结果,搜索 deepseek 没有结果。
预期行为:搜索工具名称时不区分英文字母大小写。
相关代码:[粘贴脱敏后的搜索入口和查询逻辑]
约束:保留分类和价格筛选;不修改数据结构;不引入新依赖。
请先判断搜索在哪一层执行、列出可能原因和验证方法,
然后提出最小修改,并说明空值和性能方面需要检查什么。
先让助手解释思路,再决定是否采用。它无法从一段代码自动知道线上实际部署、数据分布或权限设置;不确定的地方应标明并继续查证。
3. 审查修改,而不是直接接受
确认改动落在实际执行搜索的位置,并检查是否改变了其他条件的组合关系。例如,名称匹配与分类筛选原先同时生效,修复后仍应同时生效。如果项目使用数据库查询,核查大小写处理方式是否适合当前数据库及字段;如果是客户端筛选,要确认服务端分页不会让结果遗漏。
查看代码差异时,重点检查无关文件、异常处理、空值和潜在性能影响。不要为了一个搜索问题顺手改动登录、数据库配置或依赖版本。
4. 运行验证并记录结果
使用项目现有的测试和类型检查命令,再回到页面复测。至少覆盖:
DeepSeek、deepseek和大小写混合写法都能找到目标。- 空搜索、前后空格、中文关键词和不存在的关键词行为符合需求。
- 搜索与分类、价格筛选组合时仍然正确。
- 清空搜索后列表和分页恢复正常,没有新的报错。
若项目缺少自动测试,可先用表格记录每次输入和结果,再按项目实际情况补充有意义的测试。将新的报错和脱敏后的复现步骤交给助手继续排查;发布前由开发者确认差异、验证结果和回滚方式。
下一步练习
将需求改成“搜索词前后有空格也能匹配”,重复上述过程。先写清预期,再检查空白搜索、纯空格输入和已有筛选是否受影响。
延伸阅读
- AI 编程入门:完成第一个小功能:了解提出需求、审查修改和验证的完整过程。
- OWASP 日志安全指南:了解日志中哪些敏感信息需要避免直接记录或传递。
