VSCode原生/**回车仅支持简单函数签名，Document This插件可稳定生成跨语言注释。其触发需光标置于函数名正上方，快捷键Ctrl+Alt+D（Win/Linux）或Cmd+Alt+D（macOS），并注意配置includeDescription、dateformat和jsdocReturnType三项关键设置。
VSCode 本身支持 /** 回车生成基础 JSDoc 模板，但仅限于简单函数签名识别；真正稳定、可定制、跨语言的注释块生成，必须依赖插件——Document This 是目前最轻量且准确率最高的选择，尤其对 TypeScript 和现代 JavaScript 项目。
为什么 /** 回车经常不生效或参数类型为空？
VSCode 原生行为只解析最简函数声明（如 function foo(a, b)），一旦出现解构参数、箭头函数、TS 类型标注缺失、或函数体在另一行，它就无法提取参数名和类型。常见表现是生成的 @param 后面只有空占位符，甚至漏掉整个字段。
- 确认右下角语言模式是否为
JavaScript或TypeScript（不是Plain Text或JSON） - 确保函数定义是“可静态分析”的：避免
const fn = ({ a }) => {}这类解构形参，改用function fn(obj) { const { a } = obj; } - TS 项目中，若未启用
compilerOptions.allowJs: true或缺少.d.ts，原生提示会退化为 JS 行为 -
Prettier插件可能在保存时自动删掉空行或格式化注释结构，导致后续触发失败
Document This 的正确触发方式和默认快捷键
它不依赖输入 /**，而是直接定位到函数/类/变量声明行，用快捷键触发，因此更鲁棒。安装后无需重启，但首次使用建议重载窗口（Ctrl+Shift+P → Developer: Reload Window）。
- 光标放在函数名正上方（不要在函数体内，也不要放在
export或async关键字上） - 默认快捷键：
Ctrl+Alt+D（Windows/Linux）或Cmd+Alt+D（macOS）；部分系统可能被输入法占用，可在键盘快捷方式中搜索document this修改 - 也可通过命令面板：
Ctrl+Shift+P→ 输入Document This: Document This手动执行 - 对箭头函数支持有限，建议优先用于
function声明或 TS 中带明确返回类型的const fn = (a: string): number =>
自定义模板时最容易忽略的三个配置项
打开设置（Ctrl+, ），搜索 document this，关键配置都在 documentthis. 前缀下。别只改 author，以下三项直接影响生成质量：
-
documentthis.includeDescription：设为true才会在每段注释开头加@description字段，否则默认跳过 -
documentthis.dateformat：值应为标准 moment.js 格式字符串，例如"YYYY-MM-DD HH:mm:ss"；填错会导致日期显示为Invalid date -
documentthis.jsdocReturnType：设为true才会尝试从函数体return语句推断返回类型（如return "ok"→@returns {string}），但对复杂逻辑无效，慎开
真正难的是统一团队风格：比如强制要求每个 @param 后必须跟短横线（@param {string} name - 用户名），这需要修改插件源码或换用 JSDoc Annotation 这类支持正则模板的插件——但多数项目没必要走到那一步，先用好 Document This + ESLint 的 jsdoc/require-description 规则，已能覆盖 90% 场景。
