Document This 在 Vue 中无反应，因仅支持 或 内具名函数或明确签名的箭头函数，且需语言模式为 Vue、Volar 正常运行；解构参数、响应式包装及顶层绑定均不触发。
VSCode 本身不生成注释、也不自动修复 Vue 错误——所有“自动”行为都依赖具体扩展 + 正确配置 + 语言服务就位。没配对，按快捷键就是白按。
Document This 在 Vue 中为什么光标放对了也没反应？
它只识别 script 块内标准的 JS/TS 函数声明，对 Vue SFC 的特殊结构有硬性要求：
- 光标必须在
<script setup></script>或<script></script>标签内部，且文件语言模式是Vue（右下角显示 “Vue”，不是 “HTML” 或 “Plain Text”） - 函数必须是具名函数声明（
function foo() {}）或带明确参数名的箭头函数（const foo = (a: string, b?: number) => {}），解构参数（(\{ id, name \}) => {}）会被跳过 -
<script setup></script>中的顶层绑定（如defineProps、defineEmits）不触发注释生成；只有普通函数或const fn = () => {}这类可被解析的符号才支持 - 如果用了
unref、computed等响应式包装，Document This 无法穿透推导类型，@param可能为空或为any
Vue 项目里 ESLint 保存不自动 fix，八成卡在这三个地方
ESLint 插件默认关闭自动修复，且 Vue 文件需额外桥接层才能生效：
vue-composition-api-best-practices
下载
Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
- 确保已安装官方扩展：
ESLint（by Dirk Baeumer）和Volar（非 Vetur，Volar 才支持 Vue 3setup语法的完整语言服务） - 在
.vscode/settings.json中必须显式启用："editor.codeActionsOnSave": { "source.fixAll.eslint": true }，仅靠eslint.autoFixOnSave（旧配置）已失效 - Vue 单文件组件需通过
eslint-plugin-vue解析<template></template>和<script setup></script>，检查项目中是否有eslintConfig.extends: ["plugin:vue/vue3-essential"]类似配置，否则<template></template>里的错误（如未闭合标签）根本不会被 ESLint 捕获 - 若用 Prettier，务必确认
prettier-eslint或eslint-config-prettier已禁用冲突规则，否则eslint --fix和prettier可能互相覆盖
Doxygen 注释在 Vue 里基本不可用，别浪费时间配
Doxygen 是为 C/C++/Java 设计的文档工具，对 Vue SFC 完全无感知：
立即学习“前端免费学习笔记（深入）”；
- Doxygen Documentation Generator 插件不支持
<script setup></script>语法，无法提取defineProps()的类型字段，生成的@param全是空的 - 即使强行在
<script></script>块顶部加/** */，doxygen 命令行运行时会直接跳过整个.vue文件（默认只处理.c/.h/.js） - 真正可行的替代路径是：用
typedoc+typedoc-plugin-vue处理defineProps和defineEmits类型，再配合 JSDoc 注释到函数上——但前提是函数签名清晰、无运行时动态逻辑
最常被忽略的是语言模式和插件协同：Volar 启用后，Document This 才能正确解析 setup 中的类型；ESLint 配置写对了，但 Volar 没装，<script setup></script> 里的错误照样不报。这些不是“开了就行”的开关，而是环环相扣的语义链。
