根本原因是插件默认不理解业务语义，仅机械解析字段名和类型；如tostring()生成器包含敏感字段、api插件误判路由，皆因缺乏对注解（@tostring/exclude）、装饰器或上下文的语义识别。
VSCode插件自动生成代码时，为什么生成结果总和预期不符
根本原因不是插件没装对，而是它默认不读你的业务语义——toString() 生成器只看字段名和类型，不管这个 id 是数据库主键还是前端临时标识；API 文档生成插件 只解析 @apiParam 标签，但如果你用的是 JSDoc 的 @param 或 TypeScript 类型注释，它就直接跳过。
常见错误现象：
- 生成的
toString()包含了不该暴露的敏感字段（如passwordHash） -
getUser()方法被生成了 POST 文档，因为插件误判了路由装饰器 - 字段顺序乱掉，比如
createdAt跑到了name前面，只因文件里声明顺序是反的
实操建议：
- Java 用户必须在类上加
@ToString(exclude = {"passwordHash"})注解，而非依赖插件勾选界面 - TypeScript + Express 项目，改用
@openapi装饰器替代传统 JSDoc，确保ai-doc-generator能识别 - 所有自动生成前，先确认光标落在类/函数作用域内——插件对上下文极其敏感，光标偏移一行就可能生成空内容
如何让 Prettier 和 ESLint 在自动生成时互不干扰
生成代码后立刻被格式化“揉变形”，或者 ESLint 报一堆“no-unused-vars”是因为生成器插入的占位符还没被你填完——这不是 bug，是职责没划清。
关键参数差异：
-
prettier.semi设为false，但eslint-config-prettier必须启用，否则semi规则会和 Prettier 冲突 -
editor.formatOnSave开启，但editor.codeActionsOnSave中只保留"source.fixAll.eslint"，禁用"source.organizeImports"——后者会把自动生成的 import 按字母重排，破坏模块边界
性能影响：每次保存触发两次扫描（ESLint 检查 + Prettier 格式化），若项目含 500+ 文件，首次启动延迟明显。建议在 .prettierrc 中加 "trailingComma": "none" 减少 AST 重解析次数。
自定义模板才是生成质量的决定性因素
所有“一键生成”能力都建立在模板之上，而 VSCode 默认模板只覆盖最简场景。比如 Java 的 toString() 模板默认用单引号拼接字符串，但团队规范要求双引号 + JSON.stringify；又比如 API 文档模板硬编码了 application/json，但你的微服务实际用的是 application/vnd.api+json。
实操路径：
- 找到插件模板目录：
~/.vscode/extensions/ms-java.java-*.*/snippets/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\ms-java.java-*.*/snippets/（Windows） - 复制
toString.snippet，重命名为toString-team.snippet，修改其中${1:name}为JSON.stringify(${1:name}) - 在插件设置里指定
"java.suggest.toStringTemplate": "toString-team"
注意：模板改动后必须重启 VSCode，热重载不生效；且不同语言插件模板路径结构差异极大，TypeScript 插件模板常藏在 node_modules 子包里，别直接改源码。
生成逻辑嵌入 CI 流程时最容易忽略的兼容性问题
本地生成没问题，推到 GitLab CI 就失败，八成是环境链路断了——ai-doc-generator 依赖本地 Python 环境跑 NLP 模型，而 CI 容器里只有 Node.js；Java toString 生成器调用的是 Omnisharp 的 .NET 运行时，但 CI 镜像没装 dotnet-sdk。
真实踩坑点：
- CI 脚本里执行
npx prettier --write，但生成的代码含 Unicode 符号（如箭头函数 →），而旧版 Prettier 不支持，需锁定prettier@3.2.5 - 用
vsce package打包插件时，若插件依赖fs-extra，必须在package.json的dependencies而非devDependencies中声明，否则用户安装后报Cannot find module 'fs-extra' - 团队共享模板时，路径写成绝对路径
/Users/you/templates/，新人 clone 后直接失效
真正麻烦的从来不是怎么生成，而是生成结果能否在不同机器、不同阶段保持一致——模板路径、运行时版本、插件激活时机，三者缺一不可。
