VSCode插件实现函数注解快速生成-VSCode-PHP中文网

vscode中/**+enter不生成参数和返回值，是因为其依赖ast解析函数签名，仅对具名函数声明（function foo(a,b)）有效；箭头函数、解构参数、无类型标注的ts函数等会导致@param为空或为{any}，且光标必须位于函数声明行正上方、无缩进、无空行，语言模式需为javascript/typescript。

vscode插件实现函数注解快速生成

为什么 /** + Enter 在 JS/TS 里不生成参数和返回值？

VSCode 内置的 JavaScript (ES6) Language Features 支持 /** + Enter 触发基础 JSDoc，但它只在函数声明（function foo(a, b)）且光标紧贴行首时才尝试提取参数名；箭头函数（const foo = (a, b) => {}）、解构参数（({x, y}) => {}）、无显式类型标注的 TS 函数（function f(x)），都会导致 @param 字段为空或标为 {any}。

常见错误现象：/** 按回车后只出现空块，或 @param 名全是 args、rest、甚至缺失。

确保语言模式是 JavaScript 或 TypeScript（右下角状态栏确认，不是 Plain Text）
光标必须放在函数声明行正上方、无缩进、无空行
TS 项目中，给参数加类型（function f(x: number)）能显著提升推导准确率
异步函数会自动加 @returns {Promise}，但泛型需手动补全，如 @returns {Promise<string>}</string>

Doxygen 插件在 C/C++ 中生成错位 @param 的根本原因

装了 Doxygen Documentation Generator 却生成 @param param1 而非真实参数名，大概率是插件版本不对——只有作者为 ms-vscode 的官方版本才支持从函数签名中解析参数名；第三方同名插件多用硬编码占位符，无法读 AST。

另一个关键点：触发前光标必须位于函数声明行**正上方、零空行**处。若光标在 { 行、或中间隔了一行，插件就找不到上一行的函数定义，只能生成空模板。

安装后务必重启 VSCode，否则快捷键（Ctrl+Win+T / Cmd+Option+T）可能无响应
检查 settings.json 中 doxdocgen.c.triggerSequence 是否为 "/**"（不能带尾随空格）
指针参数如 char* buf，默认不生成 [out] 标记，需手动补或改模板
返回 void 时，@return 字段仍会生成，得删掉

koroFileHeader 和 ES7+ 插件怎么选？

koroFileHeader 是通用型模板引擎，强在文件头 + 函数注释双覆盖、支持深度变量替换（ $date$ 、 $author$ 、 $description$ ），适合 C/C++/Python/JS 全语言统一规范；ES7+ React/Redux/React-Native snippets 则专注 JS/TS，用 jsdoc + Tab 插入预设片段，轻量但不可定制字段顺序或添加作者/版本等元信息。