vscode中/**回车无反应是因语言模式非js/ts或未安装vscode-jsdoc插件；参数识别失败源于箭头函数解构等写法超出插件解析能力；类型需手动完善，导出文档须依赖jsdoc或typedoc等命令行工具。
/** 回车没反应？先确认语言模式和插件状态
VSCode 默认不带 JSDoc 自动补全能力，/** 按回车后光标直接换行、不生成任何字段，基本就是两个原因：当前文件语言模式不是 javascript 或 typescript（右下角显示 plaintext 或 JSON 就无效），或者根本没装对插件。
- 检查右下角语言标识，点它 → 选
JavaScript或TypeScript - 扩展市场搜
vscode-jsdoc，认准作者spmeesseman，启用后重启窗口（Ctrl+Shift+P→Developer: Reload Window） - 别装
Document This—— 它已停更，对 ES6+ 箭头函数、解构参数支持差，且容易和 TS 类型推导冲突
函数参数识别失败？看写法是否被插件“看得懂”
vscode-jsdoc 不读 TS 类型注解，只靠解析函数签名提取参数名。一旦写法超出它能 parse 的范围，@param 就全空。
- 箭头函数 + 对象解构形参（如
const fn = ({ a, b }) => {}）→ 插件无法展开字段，会漏掉a和b - 用传统函数声明替代：
function fn(options) {}，再手动在 JSDoc 里补@param {Object} options和子字段说明 - 剩余参数（
...rest）和默认参数（timeout = 5000）可能被忽略，建议统一写成显式形参
生成的 @param 类型不准？别指望插件猜对一切
插件生成的 @param 类型（比如 {string}）只是占位符，它不会从变量赋值、TS 接口或 JSDoc 类型注释里推导真实类型。
Wjs Localizing Video
下载
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
- 如果函数有明确 TS 类型定义（如
function foo(x: number): string），插件仍可能输出@param {any} x - 想让悬停提示精准，得靠 VSCode 自身的 JS/TS 语言服务：项目根目录加
jsconfig.json，设"checkJs": true和"allowJs": true - 类型写具体些：
{Array<string>}</string>比{Array}强，{(id: number) => void}比{Function}有用
导出 HTML 或 Markdown？JSDoc 工具链才是主力
VSCode 插件只负责写注释，不负责导出文档。真正生成可浏览的 API 文档，得靠命令行工具。
- 纯 JS 项目：装
jsdoc，运行npx jsdoc -r -d docs src/，生成基础 HTML - TS 或混合项目：用
typedoc更稳，npx typedoc --out docs --excludePrivate src/，支持导航和搜索 - 要 Markdown：
npx jsdoc-to-markdown src/index.js > API.md，注意 PowerShell 可能乱码，换 CMD 执行
插件生成的注释质量，直接决定导出文档是否可用。最常被忽略的是：函数没写返回值说明，@returns 字段空着，导出时就少了一整块关键信息。
