vscode 默认不支持自动生成函数注释，需安装 document this 扩展并按 ctrl+alt+d（windows/linux）或 cmd+alt+d（macos）触发，光标须位于函数名前，支持 function、class、method 等语法定义结构，自动提取参数名与 ts 类型，但不推断语义描述，需手动补全。
VSCode 里按什么快捷键能自动生成函数注释？
默认没有。VSCode 自身不带函数注释生成功能，必须装扩展 + 配置触发方式。最常用的是 Document This 或 ES7+ React/Redux/React-Native snippets（对 JS/TS 有效），但后者只对函数声明/箭头函数等特定语法生效，且生成的是 JSDoc 框架，不是完整文档。
实操建议：
- 装
Document This扩展（作者：joelday），它支持光标停在function、const函数表达式、class、method上，按Ctrl+Alt+D（Windows/Linux）或Cmd+Alt+D（macOS）直接插入 JSDoc 块 - 确保光标位于函数名正前方（比如
function<cursor> fetchData</cursor>），否则会失败或注释错位 - 它会自动提取参数名、返回类型（TS 环境下更准），但不会推断参数含义或 @returns 描述，需手动补全
- 不支持纯对象方法（如
obj.method = () => {}），只认语法层定义的函数
为什么按了 Ctrl+Alt+D 没反应？常见卡点
不是快捷键冲突就是上下文不匹配。Document This 只在光标处于“可识别声明节点”时激活。
常见错误现象和应对：
- 光标在函数体内部（比如
function foo() { <cursor>console.log(1); }</cursor>）→ 移到foo左侧再试 - 文件没保存，或语言模式不是
javascript/typescript/typescriptreact→ 看右下角状态栏，点击切换语言模式 - 用了
export default function但没写函数名（匿名）→ Document This 不支持，必须写成export default function getName - TS 项目中参数有重载签名（overload）→ 它只读第一个签名，可能漏参，建议关掉自动参数提取：
"jsdoc.autoAddTags": false（在 settings.json 中）
类的注释怎么一键生成？class 和 constructor 要分开处理
Document This 对 class 关键字本身有效，但不会自动为 constructor 单独生成注释 —— 这是设计如此，不是 bug。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
使用场景与操作差异：
- 光标放在
class<cursor> User</cursor>行，按Ctrl+Alt+D→ 生成类级 JSDoc，含@class和简要描述占位符 - 光标放在
constructor<cursor>(props)</cursor>行，再按一次Ctrl+Alt+D→ 单独生成构造函数注释，参数自动列出 - 类中普通方法（如
getName()）同样支持，但 getter/setter 需光标落在get<cursor> name()</cursor>的get上才触发 - 如果类继承了泛型（如
class Store<t></t>），它无法识别T，@template需手写
想用内置 Snippets 替代扩展？可以，但限制多
VSCode 内置的 jsdoc snippet（输入 /** + 回车）只生成空 JSDoc 框，不自动填参。想让它智能一点，得改用户代码片段（code-snippets）。
实操建议（仅推荐给熟悉 JSON 的人）：
- 打开
Preferences: Configure User Snippets→ 选javascript.json - 加一条 snippet，前缀设为
docf，body 写："/**\n * ${1:description}\n * @param {${2:type}} ${3:param} - ${4:desc}\n * @returns {${5:type}} ${6:returnDesc}\n */" - 这样输
docf+ Tab 能快速展开模板，但依然不读函数签名，所有占位符都得手动填 - 比起扩展，这种方式更适合固定模式的小项目，或者配合 Prettier + ESLint 自动补全
@returns类型（需 TS +jsdoc/require-returns规则）
真正省时间的，还是 Document This 配合 TypeScript 类型系统 —— 参数名和基础类型能猜八成，剩下两成描述语义，得人来定。别指望全自动，也别跳过校验步骤，尤其当函数有副作用或边界条件时，注释里漏写 @throws 或 @deprecated 是高频翻车点。
