我是谁,以及我遇到了什么问题
我是一名前端开发工程师,日常主要负责内部后台管理系统迭代维护。这次临时接手一个已经两年没有大规模迭代的 Vue2 后台报表项目,原开发人员已经离职,项目文档残缺不全,只有少量零散接口文档。
业务需求:需要在数据统计报表页面,新增 3 个业务筛选条件,同时修复报表导出偶发字段缺失的隐性 bug,业务要求1 天内完成开发自测并提测。
按照以往经验:我需要花大半天通读项目代码,理清组件、接口、状态流转,再写新逻辑、复现并定位导出 bug,保守预估至少需要 1.5‑2 天,时间比较紧张。项目组件耦合较重,直接修改很容易引发其他页面副作用。
我是怎么用 TraeCode 解决这件事的
本次主要使用 IDE 模式,我保留手动审核、控制代码修改的权限,借助 TraeCode 做项目解析、定位、辅助编码与问题排查。
第一步:让 TraeCode 理解现有项目与业务需求 将整个项目导入工作区,输入提示词:
通读当前报表模块相关代码,梳理报表页面的组件结构、接口请求逻辑、现有筛选参数、导出功能完整链路;输出涉及的核心文件清单,不要修改代码,只做分析输出。
TraeCode 快速扫描,输出了关键文件列表,梳理清楚:页面组件、store 状态、请求封装、导出工具函数的调用链路,同时标记出导出函数一处异常分支,给我做重点提示。
第二步:定位改动点,输出修改方案 我把业务需求完整给到工具:
基于上面梳理的代码,给报表页面新增客户类型、业务渠道、时间粒度三个筛选条件;筛选参数要同步传给列表查询接口与导出接口;给出修改方案,标明每一处需要改动的文件与代码片段。
AI 输出完整改动方案,区分模板、交互逻辑、store 参数、导出传参四部分,我人工核对方案,确认没有破坏原有业务逻辑之后,再开始执行修改。
第三步:辅助编码、调试复现 bug 按照方案,由 TraeCode 生成基础代码片段,我做人工校验微调。 针对导出偶发字段缺失的隐性 bug,我把报错场景、复现条件给到 TraeCode,它结合代码分析,定位出:当筛选参数为空数组时,参数序列化处理逻辑异常,导致后端接收参数出错,造成导出字段丢失。 我顺着提示,复现问题,完成修复,同时补充边界判断。
第四步:整理变更,输出变更说明 全部改完之后,让 TraeCode 汇总本次所有改动,输出开发变更说明:包含新增功能点、修复的 bug、改动文件清单、自测注意事项,方便测试同学验收,也方便后续同事接手。
成果展示
- 报表页面顺利新增 3 个筛选条件,筛选可联动表格列表数据,筛选条件可以正常缓存,交互符合业务预期;
- 修复报表导出偶发字段缺失的历史隐性 bug,覆盖参数为空、多条件组合筛选等边界场景;
- 全部功能完成自测,按时交付提测;输出一份简短的变更文档,给到测试与后续维护同事;
- 改动最小化,没有影响项目其他页面原有逻辑,回归测试没有发现副作用。
效率对比
- 之前传统方式:通读陌生老项目代码梳理链路 4‑6 小时 + 编写新功能 2‑3 小时 + 复现排查隐性 bug 2‑4 小时,整体至少 1.5~2 天,还容易因为对旧代码不熟悉引入新问题。
- 使用 TraeCode 之后:项目梳理 + 定位改动点约 1 小时,编码 + bug 修复 + 自测合计约 5 小时,整体 1 个工作日完成全部任务。
对比最大收益:不用逐行啃耦合老旧代码,快速拿到项目链路视图,把大量时间留给人工校验、业务自测,而不是耗在阅读理解旧代码上。
经验和技巧总结
- 接手耦合度高的老旧项目,优先用 IDE 模式,只让 AI 做分析、输出方案,不要直接让 AI 大批量自动改代码,人工确认方案之后再落地,降低改崩老业务的风险。
- 给 AI 需求的时候,优先让它 “先分析、再出方案,确认后再改代码”,也就是先理解再动手,不要上来直接让写代码,减少反复返工。
- 隐性偶发 Bug 排查,可以把复现现象、出现条件完整给到 TraeCode,结合代码库扫描,往往可以快速定位容易被人忽略的边界分支。