VSCode原生JSDoc需满足三点：语言模式为JS/TS、光标在函数声明正上方空行、函数有明确参数名；Document This不支持解构和箭头函数；koroFileHeader需手动填类型；推荐用代码片段jsdoc实现轻量可控。
VSCode 本身不依赖插件就能生成基础 JSDoc 参数注释，但“自动化”程度取决于你用的是原生功能、Document This 还是 koroFileHeader——三者触发逻辑、支持语法、变量写法完全不同，混用必冲突。
为什么 /** 回车没生成 @param？检查这三点
这不是插件失效，而是 VSCode 原生 JSDoc 模板生成有硬性前提：
- 当前文件右下角语言模式必须是
javascript或typescript（不能是 Plain Text） - 光标必须落在函数声明行正上方的空行（如
function foo(a, b) {的上一行），不能在函数体内或已有注释中 - 函数必须有明确参数名（
function bar({ id, name })或const fn = (a) => {}都不被识别）
Document This 插件：适合带类型签名的函数，但不认解构和箭头表达式
它基于 AST 推导 @param 类型，比原生更准，但只对“标准函数声明”和“有 TS/JSDoc 类型标注”的场景可靠：
- ✅ 支持：
function fetchUser(id: string): Promise<user></user>→ 自动补@param {string} id和@returns {Promise<User>} - ❌ 不支持：
const handler = ({ userId, role }) => {}（解构参数全丢）；const fn = () => 42（箭头函数表达式体不触发） - ⚠️ 注意：
document-this.insertDescription默认为false，会导致@description空着，建议设为true
koroFileHeader：稳定跨语言，但 @param 类型要手动填
它不解析 JS 类型，只做纯文本模板填充，所以不会因语法新特性崩，但也不会自动推导 @param {string} 这类类型：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 模板里写
* @param {string} $1 - $2，它就照搬，$1/$2 是光标占位符，不是自动识别的参数名 - 快捷键
Ctrl+Alt+T（Win）触发后，光标停在第一个$1，你得自己输参数名，再 Tab 到$2写描述 - 好处是：支持中文变量名（如
@param {number} 用户ID）、支持$date$自动更新时间、不依赖语言服务，JS/TS/Python 全通用
用户代码片段（Snippets）：最轻量可控，推荐用于高频函数模板
用 javascript.json 配一个简短 prefix，比如 jsdoc，避免和插件快捷键打架：
{
"JSDoc Function": {
"prefix": "jsdoc",
"body": [
"/**",
" * @description ${1:功能说明}",
" * @param {${2:any}} ${3:paramName} - ${4:参数描述}",
" * @returns {${5:any}} ${6:返回说明}",
" */"
],
"description": "手动可控的 JSDoc 函数模板"
}
}
这样输入 jsdoc + Tab，光标依次停在描述、类型、参数名、参数描述等位置，填完即用。不用装插件，不随插件更新变行为，也绕开了 Document This 对解构/箭头函数的识别缺陷。
真正难的不是生成注释，而是让 @param 类型写得准、跟函数实现一致——所有插件都做不到这点，最终还得人看一眼函数体再敲一次键盘。
