我用 TraeCode 接手陌生前端项目,迅速完成开发计划提前完工不加班的日常

一、我是谁,以及我遇到了什么问题

我是前端开发,主要负责 Vue 技术栈的 B 端业务系统开发。这次接到一个任务:接手一个同事离职后留下的后台管理系统项目(Vue 3 + Element Plus + Pinia + Vite),需要在两天内完成一个「数据导出中心」模块的开发——包含导出任务列表、导出配置表单和导出记录详情三个页面。

问题在于:我对这套代码几乎不熟。项目用了 Pinia 做状态管理,组件之间有大量自定义封装,路由和权限控制也有一套自己的逻辑。如果按传统方式,我需要先花大半天时间读代码、问同事、理清数据流,才能动手写新功能。

实际场景:接手陌生前端项目,要在两天内交付一个包含列表页 + 表单页 + 详情页的新功能模块。

二、我是怎么用 TraeCode 解决这件事的

这次我结合使用了 IDE 模式SOLO 智能体模式,大致分四步走:

第一步:用 SOLO 模式让 TraeCode 理解项目结构和数据流

我先用 SOLO 智能体模式,让 TraeCode 通读整个项目,帮我梳理出关键信息:

  • 项目目录结构、路由配置方式、页面组件组织约定
  • Pinia store 的定义模式(如何定义 state / actions / getters)
  • 已有的 API 请求封装(request.js 里的拦截器、响应处理)
  • Element Plus 组件的二次封装(比如项目里自定义的 ProTableSearchForm
  • 权限指令 v-permission 的使用方式

提示词参考:「这是一个 Vue 3 + Element Plus + Pinia 的后台管理系统,请帮我分析项目结构,重点梳理:1) 路由和页面组织方式;2) 状态管理定义模式;3) API 请求封装;4) 组件复用约定。给我一份结构化总结。」

第二步:用 IDE 模式定位参考页面,生成新功能代码

TraeCode 帮我找到了项目里已有的一个类似功能页面(「操作日志」模块),我让它参考这个页面的写法,生成导出中心三个页面的骨架代码:

  • 导出任务列表页:参考已有 ProTable 用法,生成带搜索表单 + 分页表格的页面
  • 导出配置表单页:参考已有 DialogForm 组件,生成配置表单弹窗
  • 导出记录详情页:生成详情展示页面,复用项目的描述列表组件

同时让 TraeCode 按照项目的 Pinia store 模式,新建对应的 exportStore.js,定义好 state 和 actions。

提示词参考:「参考 src/views/system/log 目录下的操作日志页面写法,帮我创建导出中心模块:1) 列表页 ExportTaskList.vue;2) 配置表单 ExportConfigDialog.vue;3) 详情页 ExportRecordDetail.vue。store 参考已有 logStore.js 模式新建 exportStore.js。API 接口我先写 mock。」

第三步:切换 SOLO 模式补全路由、权限和类型定义

页面骨架有了,接下来需要把路由、权限、TypeScript 类型定义都补上。我切回 SOLO 智能体模式,让它一次性完成:

  • router/modules 下新增导出中心的路由配置
  • 在权限配置中注册新菜单
  • 补充 types/export.d.js 类型定义文件
  • 检查是否有遗漏的 import 和组件引用

第四步:用 IDE 模式调试联调,整理变更

代码写完后,我把 API mock 换成真实接口,在 IDE 模式下逐个页面调试:

三、成果展示

最终交付了三个完整的页面和一个 Pinia store 模块:

  • 导出任务列表页:支持按任务名称、状态、时间范围搜索,分页展示导出任务,可触发重新导出
  • 导出配置弹窗:支持选择导出字段、导出格式(Excel / CSV),保存配置
  • 导出记录详情页:展示单条导出记录的完整信息,包含导出状态、文件下载链接

功能完成后通过了联调测试,当天提测,测试同学第二天反馈通过。同时整理了一份变更文件清单(共新增 8 个文件、修改 3 个文件),方便后续同事接手维护。



四、效率对比

对比项 以前的做法 用 TraeCode 后
理解项目 手动翻目录、问离职同事、看 Git 历史,大半天才能理清数据流 SOLO 模式通读项目,30 分钟拿到结构化总结
编写页面 从零手写或复制粘贴改,容易漏掉项目封装约定 参考已有页面模式生成骨架,直接符合项目规范
补全配置 路由、权限、类型逐个手加,容易遗漏 SOLO 模式一次性补全,自动检查引用
整体耗时 2 天(含读代码 + 写功能 + 调试) 约半天(4 小时左右完成开发 + 联调)

效率提升:从原来的 2 天缩短到半天,提速约 4 倍。最大的收益不在写代码本身,而在于接手陌生项目的"理解成本"被大幅压缩——以前最耗时的"读懂别人代码"环节,TraeCode 帮我快速跨越了。

五、经验和技巧总结

  1. 先用 SOLO 模式"扫描"项目,再动手写代码。接手陌生项目时,先让智能体通读整个代码库,输出结构化的项目分析,比逐个文件读效率高得多。尤其要注意让它总结"项目里的封装约定"(比如自定义组件用法、store 定义模式),这样后续生成的代码才能直接符合规范,不用反复改。
  2. IDE 模式适合精确控制,SOLO 模式适合批量操作。写具体页面逻辑时我更倾向 IDE 模式,因为可以逐步审查每段代码;但涉及"新增多个文件 + 修改路由配置 + 补类型定义"这类跨文件批量操作,SOLO 智能体模式明显更高效,它能自己规划和执行多步任务。
  3. 让 TraeCode 参考已有代码生成,而不是从零描述。与其描述"帮我写一个列表页",不如说"参考 src/views/system/log/index.vue 的写法,帮我生成类似结构的页面"。这样生成的代码天然贴合项目风格,后续改动量小很多。
1 个赞