
老前端项目最让人头疼的不是业务多复杂,而是当年用 Vue 2 选项式 API 写出来的“面条代码”。几千行的 `.vue` 文件里,`data`、`methods`、`computed` 乱作一团,业务逻辑全靠注释硬撑。这时候想加个新功能,或者把状态抽离到全局,简直是在拆炸弹。
很多人觉得让 AI 帮你重构代码很简单,直接把代码丢给大模型说“帮我转成 Vue 3 组合式 API”。结果往往惨不忍睹:大模型要么漏掉边界条件,要么把状态管理搞得支离破碎,生成的 Pinia 仓库根本跑不起来。
问题不在大模型不行,而是你给它的提示词太糙。今天咱们就用实战工作流,拆解如何通过精细化提示词工程,指挥 Claude 3.5 Sonnet 或 GPT-4o 优雅地把旧项目逻辑拆解并重构。
一、 为什么常规重构提示词会翻车?
在动手写提示词之前,先看一组对比。传统盲目提问和结构化提示词重构的实际效果差距非常明显:
| 维度 | 传统盲目提问(翻车重灾区) | 结构化提示词重构(高效落地) |
|---|---|---|
| 输入方式 | “把这段 Vue 2 代码转成 Vue 3 组合式 API。” | 设定角色、提供上下文、明确重构规范、限定输出格式。 |
| 代码结构 | 依然是面条代码,只是换成了 `setup()` 语法糖。 | 按业务领域(Composable)严格拆分,职责单一。 |
| 状态管理 | 滥用全局响应式,甚至把局部状态全部塞进 Pinia。 | 本地状态用 `ref/reactive`,跨组件共享用 Pinia(Setup 语法)。 |
| 可维护性 | 无法直接运行,缺少 TypeScript 类型推导。 | 包含完整 TS 类型定义,边界条件处理清晰,开箱即用。 |
二、 核心大模型选型与参数配置
重构代码这种任务,对大模型的逻辑推理能力和长文本输出窗口要求极高。目前在代码重构实战中,不同模型的表现有明显分工:
•Claude 3.5 Sonnet (Anthropic):目前写前端代码的首选。它的代码生成逻辑极其严密,对 Vue 3 组合式 API 的闭包、生命周期钩子理解最到位,极少出现低级语法错误。
•GPT-4o (OpenAI):适合处理复杂的架构拆分和业务逻辑逆向工程,但在长代码的缩写和上下文保持上,有时会偷懒使用 `// … 略`,需要额外在提示词中限制。
•Gemini 1.5 Pro / 2.0 (Google):拥有超大上下文窗口,如果你需要把整个旧项目的几十个文件一次性喂给它做全盘重构,它是唯一能稳稳吃下整仓代码的选择。
实测推荐参数设置:
•Temperature (温度值):设为 0.2 至 0.3。重构代码不需要大模型的“创造力”,我们需要的是严谨、确定性高的工业级代码。
•Top_P:设为 0.9。
三、 实战拆解:重构提示词工程 SOP
要想让 AI 完美重构,必须把任务拆解为三个步骤:业务逻辑剥离、Composable 封装、Pinia 状态收敛。
我们直接上生产环境级别的提示词模板。你可以直接复制这个结构,根据自己的业务替换变量。
步骤 1:系统指令与角色设定 (System Prompt)
你是一位精通 Vue 3 组合式 API (Composition API)、Pinia 状态管理以及 TypeScript 的资深前端架构师。
你的任务是将旧版 Vue 2 选项式 API 代码,重构为高内聚、低耦合的现代 Vue 3 模块化代码。
重构必须严格遵循以下原则:
1. 严禁使用选项式 API (Options API) 或 `this` 关键字。
2. 优先使用 `<script setup>` 语法糖。
3. 必须为所有响应式数据和函数添加完整的 TypeScript 类型定义。
4. 业务逻辑必须拆分为独立的 Composable 函数(命名以 `use` 开头)。
5. 严禁在代码中使用 `// ... 剩余代码省略`,必须输出完整的、可直接运行的代码。
步骤 2:用户输入提示词模板 (User Prompt)
请帮我重构以下旧版 Vue 2 组件。
### 【组件背景与业务功能】
这是一个电商后台的“商品编辑页”,目前包含商品基本信息维护、SKU 表格动态生成、类目联动选择三个核心业务板块。代码里充斥着大量的混杂逻辑和全局事件总线。
### 【旧版源码】
// 贴入你的旧版 Vue 2 代码
export default {
data() {
return { … }
},
methods: {
fetchData() { … },
handleSkuChange() { … }
},
mounted() {
this.init()
}
}
### 【重构目标要求】
1. **逻辑拆分**:将“类目联动”和“SKU生成”分别提取为独立的 `useCategory.ts` 和 `useSku.ts` 组合式函数。
2. **状态管理**:将跨组件共享的商品基础数据,剥离到一个独立的 Pinia Store 中(采用 Setup Store 语法)。
3. **输出格式**:
- 首先输出拆分后的两个 Composable 文件代码。
- 其次输出 Pinia Store 代码。
- 最后输出重构后的主组件 `<script setup>` 代码。
四、 代码落地:AI 生成结果的验收与修正
当你把上面的提示词丢给 Claude 3.5 Sonnet 后,它会输出结构清晰的代码。此时,你作为技术把关人,需要重点检查以下几个坑:
1.响应式丢失问题:
检查 AI 在解构 Composable 返回的对象时,是否使用了 `toRefs` 或 `toRef`。如果不小心直接解构了响应式对象,会导致视图失去响应。
*错误写法:*
const { list, loading } = useCategory(); // 视图失去响应
*正确写法:*
const { list, loading } = storeToRefs(useCategoryStore()); // Pinia 场景
// 或者在普通 Composable 中保持对象引用
const categoryLogic = useCategory();
// 模板中使用 categoryLogic.list
2.生命周期钩子迁移:
旧版的 `mounted` 必须被正确转换为 Vue 3 的 `onMounted`。检查 AI 是否在 `setup` 顶层直接执行了需要 DOM 渲染后才能调用的异步逻辑。
3.Pinia 内存泄漏与副作用:
检查 Pinia 的 Action 中是否存在未清理的定时器或事件监听。如果旧代码里有 `window.addEventListener`,重构后的 Composable 必须显式在 `onUnmounted` 中进行 `removeEventListener` 清理。
五、 批量重构的工作流自动化建议
如果你面对的是一个包含几十个甚至上百个旧组件的中大型项目,靠手动复制粘贴写提示词会累死。这时候可以把上述提示词固化为一个本地的 CLI 辅助脚本,或者结合 Cursor、Windsurf 等 AI IDE 的 `.cursorrules` 配置文件。
在项目根目录下创建 `.cursorrules` 文件,内容写入:
{
"project_type": "Vue 3 + Vite + Pinia + TypeScript",
"refactor_rules": [
"Refactor Options API to Composition API with <script setup>.",
"Extract business logic into composables prefixed with 'use'.",
"Use Pinia Setup Store syntax for global state.",
"Do not omit any code; provide fully implemented files."
]
}
这样,当你选中旧代码右键让 AI 重构时,它会自动应用这套严格的工程规范,产出可以直接通过 Lint 检查的高质量代码,彻底摆脱旧项目维护的泥潭。

评论前必须登录!
立即登录 注册