让 vscode ai 插件生成可直接提交的业务代码，核心是通过配置文件、@template 注释和自定义 snippet 喂入业务上下文；需人工把关第三方 sdk、跨文件联动和 orm 关联查询等场景。
为什么你生成的代码总要手动改一遍？
因为大多数 VSCode 代码生成插件（比如 AI Code Generator、Tabnine、GitHub Copilot）默认不理解你的业务语义和团队规范——它只懂语法，不懂“这个接口必须带 X-Trace-ID 头”“DTO 字段命名要 snake_case”“Service 层禁止直接调用数据库”。不配置就开用，等于让 AI 猜需求。
怎么让插件输出可直接提交的业务代码？
核心是给插件“喂上下文”，不是调参数。关键动作有三类：
- 在当前工作区根目录放
.vscode/settings.json，写入"editor.suggest.snippetsPreventQuickSuggestions": false（否则代码片段和 AI 建议会打架） - 用
/* @template */注释块在文件顶部声明约束，例如：/* @template - 使用 axios 封装的 request 方法 - 错误统一 throw new BizError(code, message) - 参数校验用 zod.object() */
- 对高频模块建自定义 snippet（不是插件自带的通用模板），比如
api-service片段里固定包含cancelToken和timeout: 10000
Copilot + 自定义 prompt 的真实效果差异
直接输入 “写个用户登录接口” 和加上约束后效果天差地别：
- 没约束：生成含
req.body.password明文读取、无 CORS 配置、返回res.send()的 Express 代码 - 加了
/* @rule express-api, auth-middleware-required, return-401-on-fail */后，自动插入if (!ctx.user) throw new AuthError();，且返回格式匹配你项目里已有的SuccessResponse类型 - 注意：Copilot 不识别注释里的中文，必须用英文关键词，且
@rule后面不能有空格
哪些场景下插件一定会翻车？
别指望 AI 替你做决策，这几类必须人工把关：
- 涉及第三方 SDK 调用（比如微信支付回调验签），插件大概率用错
crypto.createVerify()的哈希算法参数 - 需要跨文件联动的逻辑（如新增一个状态码，要同步改
enum StatusCode、errorMap.ts、Swagger 注释），插件只改当前文件 - ORM 关联查询生成的
include或relations配置，常漏掉nested: true导致序列化失败
最省事的做法：把插件当“高级补全”，不是“代写员”。它填骨架快，但血肉（边界判断、错误路径、可观测埋点）还得你来长。
