VSCode插件需配合显式配置与工作区约束才能生效；Doxygen插件依赖系统doxygen工具；Java生成功能要求项目被正确识别且语言模式设为Java；工作区settings.json是标准化关键，须配置格式化、默认格式器及禁用自动缩进探测。
VSCode 插件本身不自动标准化代码生成，真正起作用的是插件 + 显式配置 + 工作区约束的组合。光装插件、不配 settings.json 或忽略语言模式，90% 的“自动生成”功能会静默失效。
Doxygen Documentation Generator 必须配对 doxygen 命令行工具
这个插件只写注释模板，不解析也不生成文档——它依赖系统 PATH 中的 doxygen 可执行文件。没它，Alt+Shift+D 按下去毫无反应，连错误提示都没有。
- macOS：运行
brew install doxygen后，必须执行doxygen -v确认输出版本（如1.9.8） - Windows：安装官方
doxygen-1.9.8-setup.exe时，务必勾选 Add doxygen to PATH，否则 VS Code 内置终端里which doxygen返回空 - Linux：用
sudo apt install doxygen安装后，检查which doxygen是否返回路径（如/usr/bin/doxygen） - VS Code 终端中运行
doxygen -g Doxyfile报command not found？立刻停手，回退重装 doxygen
toString 生成类插件在 Java 项目里极易失效
VS Code 的 Java 扩展（如 redhat.java）对自动生成支持有限，很多“右键 → Generate toString”选项根本不出现在上下文菜单里——不是插件坏了，是项目没被识别为 Java 项目。
- 确保文件夹下有
pom.xml或build.gradle，且 VS Code 已加载 Java 语言服务器（状态栏右下角显示Java） - 打开的文件语言模式必须是
Java（右下角点击 Plain Text → 选 Java），否则插件完全不监听 - 更可靠的做法是用 Lombok：
@ToString注解 +maven-compiler-plugin配置 annotationProcessor，编译期生成，不依赖编辑器 - 如果坚持用 IDE 生成，优先选 Eclipse-based 插件（如
vscode-java-debug配套的Extension Pack for Java），比纯 VS Code 自研生成器稳定
工作区 settings.json 是标准化落地的关键开关
插件行为是否统一，不取决于你装了什么，而取决于 .vscode/settings.json 里是否强制覆盖了关键参数。用户级设置会被工作区设置完全屏蔽。
- 必须显式设置
"editor.formatOnSave": true，否则 Prettier/ESLint 不会在保存时触发 - 指定默认格式化器：
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }，避免不同成员用不同插件格式化 - 禁用自动缩进探测：
"editor.detectIndentation": false，防止从旧文件继承错误的tabSize - 把
.vscode/extensions.json一并提交 Git，用"recommendations"字段声明必需插件，新成员打开即提示安装
最容易被忽略的点：所有生成类插件都依赖“当前文件被正确识别为某语言”。右下角语言标识不是装饰，它是插件工作的前提条件。切错语言模式，等于关掉了整个自动化流水线。
