VSCode原生不支持在class行直接触发JSDoc模板，需将光标置于class正上方空行输入/**+回车；constructor需单独处理，且语言模式必须正确识别为javascript/typescript等。
VSCode 里 class 关键字本身不触发自动注释生成
直接在 class 前按 Ctrl+/ 或 Cmd+/，只会加一行 // 或 #，不会弹出 JSDoc 模板——这不是快捷键失效，而是 VSCode 原生不支持「光标停在 class 行就自动生成类文档」。真正能触发标准注释模板的，是语言扩展（如 TypeScript 官方、JSDoc 插件）配合特定输入模式。
用 /** + 回车触发类注释模板（JavaScript/TypeScript）
把光标放在 class 关键字**正上方空行**，输入 /** 然后回车，VSCode（配合 TypeScript 或 JSDoc 扩展）会自动补全为：
/**
*
*/
class MyClass {
这个行为依赖以下条件：
-
languageId必须是javascript、typescript或typescriptreact（不是plain text或json） - 文件后缀需匹配，如
.ts、.tsx；.js文件需开启// @ts-check或配置"javascript.preferences.includePackageJsonAutoImports": "auto" - 未禁用
editor.suggest.snippetsPreventQuickSuggestions（否则代码片段不弹）
constructor 不会自动获得独立注释块
Document This、Auto Import 等主流插件对 class 生成注释后，constructor 方法仍需手动处理。常见错误是以为按一次 /** + 回车就能覆盖整个类结构——实际它只作用于当前光标位置，不会递归扫描成员函数。
正确做法是：
- 在
constructor()上方空行单独输入/**+ 回车，生成独立构造函数注释 - 或使用多光标：按
Ctrl+Shift+L（Win/Linux）选中所有方法名，再输入/**+ 回车（部分扩展支持批量触发） - 不要依赖「一键全类注释」——目前没有稳定跨语言、跨项目结构的通用方案
Python 类注释靠 """ + 回车，但非 JSDoc 风格
在 class 行上方输入 """ 并回车，VSCode 会生成三引号字符串模板，内容取决于是否安装了 Python Docstring Generator 等扩展：
""" Summary of the class. <p>Args: ... """</p>
注意区别：
- 这是字符串字面量，不是语法级注释（会被解释器读取，影响
help()和 IDE 提示） - 不等价于 JavaScript 的
/** */，不能被 TSDoc 或 typedoc 解析 - 若想统一风格，需在
settings.json中配置："python.editor.suggest.autoImports": true，并确保 Python 扩展已启用 docstring 支持
最常被忽略的一点：类注释是否生效，和文件是否被识别为对应语言强相关。右下角状态栏显示 Plain Text 时，/** 回车什么都不会发生——哪怕你写的是标准 TypeScript 代码。
