<p>在VSCode中用Fitten Code为JavaScript函数添加文档注释，需选中完整函数体后右键选择“生成注释”，并通过设置启用JSDoc生成功能以输出/* /格式；未启用则默认生成//单行注释；验证时需确认悬停提示、参数补全及类型跳转正常。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在VSCode中用Fitten Code为JavaScript函数快速添加专业级文档注释时，需要根据项目规范在普通单行注释（//）和结构化JSDoc注释（/** */）之间灵活切换，避免手动重写或格式错乱。
选中代码后触发注释生成
打开一个含函数定义的JS文件，用鼠标或键盘精准选中整个函数体（包括function关键字、函数名、参数列表、花括号及内部语句），确保不遗漏首尾符号。
右键→选择“Fitten Code – 生成注释”，不要点“开始聊天”或“编辑代码”，否则不会触发注释模板生成逻辑。
这一步操作起来很简单，直接把函数块框住再右键就行。如果只选中函数内部语句而漏掉function myFunc() {这一行，Fitten Code将无法识别函数签名，生成的注释会缺失@param和@returns字段。
区分标准注释与JSDoc注释输出
生成注释后，默认输出的是标准单行注释格式（每行以//开头），适用于快速说明、调试标记等轻量场景。
若需转为JSDoc格式，必须在生成前完成关键设置：打开VSCode设置（Ctrl + ,）→搜索fitten code jsdoc→勾选【Enable JSDoc generation for JavaScript/TypeScript】。
该选项未启用时，即使对同一函数重复执行“生成注释”，也始终输出//风格；启用后，下次生成将自动套用/** */包裹+标准标签结构。
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
手动强制切换已有注释类型
方法一：删除现有注释→重新选中函数→右键“Fitten Code – 生成注释”（依赖上一步设置是否开启）。
方法二：保留原注释内容，仅替换外壳——选中已生成的//注释块→按Ctrl + H调出替换面板→查找：//\s*→替换为：*/→点击全部替换→再将光标移至注释最前→输入/**→回车补全闭合星号与斜杠。
注意：此法仅适用于纯文本替换，若注释中已含@param等JSDoc专用标签但被//包裹，强行替换外壳会导致IDE无法解析，建议优先用方法一。
验证JSDoc是否生效
① 将光标悬停在已标注JSDoc的函数名上，确认弹出气泡中显示完整参数说明与返回值描述；
② 在函数调用处输入该函数名+左括号，检查参数提示是否带类型与文档摘要；
③ 打开命令面板（Ctrl + Shift + P）→输入“JavaScript: Go to Type Definition”→回车跳转，确认能正确定位到源函数而非注释文本本身。
若第③步失败，说明JSDoc语法存在错误，常见原因是@param后缺少变量名或类型未用花括号包裹，例如写成@param userName string应改为@param {string} userName。
