返回 AI 教程
AI 入门指南

AI 编程入门:安全地完成第一个小功能

从描述需求、检查改动到运行测试,建立可复用的 AI 编程流程。

姑大姑爷的AI导航

适合谁

如果你已有一个可以运行的网页项目,可以让 AI 帮忙完成范围明确的小功能。本教程以“给工具列表增加名称搜索”为例,重点是描述需求、审查修改和验证结果。工具可能修改文件或运行命令,开始前先了解其权限,并确保项目已有可恢复的备份或版本记录。

常见选择包括 TRAE、Cursor、GitHub Copilot 和 OpenAI Codex。安装方式、功能和费用以各工具的当前文档为准。

第一步:准备项目上下文

先按项目自己的说明启动应用并确认原功能正常。记录使用的框架、运行命令和相关文件;不要把 .env、密码、API 密钥或未经授权的数据粘贴给助手。

然后写清一个小需求:

请在现有工具列表页面增加名称搜索。
要求:输入关键词后筛选名称,忽略首尾空格;空输入时显示全部工具;
无匹配结果时显示“没有找到相关工具”。保留现有样式和分页行为。
先检查现有实现并说明拟修改的文件;完成后运行项目已有检查,
列出改动和仍需人工验证的情况。

如果项目数据来自服务端,还要说明搜索应在前端还是服务端进行;不确定时,让助手先说明现有数据流及两种做法的影响。

第二步:先看方案,再看代码

确认助手找到的是实际页面,而不是另建一个未使用的组件。阅读文件差异,重点检查:

  • 搜索范围和大小写处理是否符合需求;空格与空值如何处理。
  • 搜索与分类筛选、分页组合时是否还能找到预期结果。
  • 是否引入不必要的依赖,或修改认证、数据库、配置等无关部分。
  • 是否有密钥、私人数据或调试日志被意外写入代码。

不要仅凭“已完成”就合并或上线;不理解的变更应先让助手解释,必要时请熟悉项目的人审查。

第三步:按验收场景测试

按项目文档运行已有的构建、类型检查或测试,再在浏览器里操作:

场景预期结果
输入存在的名称显示匹配工具
输入不存在的名称显示空结果提示
输入前后空格按需求忽略空格
清空输入恢复显示工具
搜索后切换分类或页码结果与当前筛选条件一致

如果出现问题,把实际操作步骤、期望结果和错误信息提供给助手,请它先定位原因再修改。再次运行受影响的检查,并重新查看差异。

最后:由人确认发布

确认测试通过、影响范围清楚,再按团队流程发布。涉及数据库、支付、权限或生产数据时,先设计备份和回滚方案并进行针对性审查;AI 生成的代码仍需要开发者负责维护。

延伸阅读:GitHub:审查 Copilot 的代码变更。

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