Ctrl+/(Windows/Linux)或Cmd+/(macOS)用于切换当前行注释状态，智能判断增删行注释符；多行选中时逐行处理；语言模式决定注释符，异常时需手动设置语言模式。
Ctrl+/ 不是接口注释专用键，它只做语言级行注释切换
VSCode 默认没有“接口注释快捷键”这个概念——Ctrl+/（Windows/Linux）或 Cmd+/（macOS）本质是「切换当前光标所在逻辑行」的注释状态，和是否为接口无关。它不会识别函数签名、参数、返回值，也不会生成 JSDoc 或 Swagger 格式注释。
如果你在 .ts/.js 文件里写了 function getUser(id: number)，按 Ctrl+/ 只会加 //，不是 /** @param id ... */。
- 它依赖当前
languageId（如typescript），不是文件内容语义 - 接口（interface）、类型（type）、函数声明，都一视同仁地加/删单行前缀
- 想生成结构化 API 注释，必须用插件或自定义代码片段，不能靠默认快捷键
生成 JSDoc / TS Doc 接口注释：用 Ctrl+Shift+P + “Comment” 命令
VSCode 内置了 editor.action.commentLine，但没内置“生成函数文档”命令；真正能触发 JSDoc 模板的是语言服务器或插件提供的上下文命令。
在 TypeScript/JavaScript 文件中，把光标放在函数名或 interface 关键字上，按 Ctrl+Shift+P 打开命令面板，输入：
-
Insert JSDoc comment（来自 TypeScript 官方语言服务）→ 生成/** ... */框架，自动提取参数名 -
Document This（需安装同名插件）→ 支持 @param/@returns/@example，且可配置模板 - 注意：这些命令不绑定默认快捷键，首次使用得手动搜；可自行映射为
Alt+J等组合
示例：光标停在 getUser 上，执行 Insert JSDoc comment 后生成：
/**
* @param {number} id
*/Swagger/OpenAPI 接口注释：靠插件调用后端 API，非本地快捷键
所谓“从 Swagger 接口生成注释”，实际是插件读取远程 /swagger.json 或本地 YAML，解析路径、方法、schema，再往代码里插入对应注释。这不是 VSCode 原生能力，也不存在一键快捷键。
典型流程（参考 CSDN 博客中插件开发逻辑）：
- 选中一段代码（如 Express 的
app.get('/user', ...)） - 运行插件注册的命令（如
extension.summary） - 插件调用
axios.post()请求 Swagger 接口，传入选中文本 + 当前languageId - 后端返回注释内容（如 Java 的
@ApiOperation或 TS 的 JSDoc），插件再用vscode.workspace.applyEdit()插入
关键点：languageId 必须准确（比如 typescriptreact 而非 typescript），否则插件查不到 symbol['typescriptreact'] 映射，直接报“不支持当前语言”。
为什么你按 Ctrl+/ 后什么都没变？三个最常忽略的硬性条件
不是快捷键失效，而是 VSCode 根本没启动注释逻辑。检查这三项：
- 右下角状态栏显示的 language mode 是
plaintext或空？→ 点击它，手动选typescript/javascript/python - 光标落在行末空白处（比如
function foo() {<cursor></cursor>）？→Ctrl+/会在行尾加//，看起来像没反应；移到{上重试 - 装了 Vim / Emacs 插件？→ 它们常劫持
Ctrl+/；打开Preferences: Open Keyboard Shortcuts (JSON)，搜editor.action.commentLine，确认没被覆盖
特别注意：JSON、YAML、TOML 等格式本身不支持注释，VSCode 会静默跳过 —— 这不是 bug，是标准限制。
