直接禁用或卸载插件是最稳妥做法,因注释生成插件(如autoDocstring、Document This、KoroFileHeader)普遍缺乏“仅停用模板”的粒度开关,启用即生效,监听/**回车等行为自动插入,VS Code亦无统一功能级开关。

直接禁用或卸载对应插件是最稳妥的做法,而不是试图“关闭模板”——因为多数注释生成插件(如 autoDocstring、Document This、KoroFileHeader)没有“仅停用注释模板但保留插件”的开关。
为什么关不掉注释模板?
这些插件的设计逻辑是「启用即生效」:一旦安装并激活,它们会监听特定触发行为(比如输入 /** 回车、保存文件、调用快捷键),然后自动插入模板。VS Code 本身不提供统一的「插件功能粒度开关」,插件作者也极少暴露「只禁用注释生成,其他功能照常」的配置项。
-
autoDocstring没有禁用 JSDoc 生成的配置项,"autoDocstring.enabled": false这类设置不存在 -
Document This的所有行为都绑定在/**触发上,删掉插件才能彻底停止 -
KoroFileHeader虽然可通过"fileheader.autoAdd": false关闭头部注释,但它不控制函数级 JSDoc 模板
怎么真正停掉函数注释自动生成?
分三类情况处理,选最匹配你当前状态的:
- 如果你只是偶尔不想生成,按
Ctrl+Z撤回即可——这是最快捷的临时方案 - 如果常用语言是 Python,检查是否启用了
autoDocstring:打开命令面板(Ctrl+Shift+P),输入Extensions: Show Installed Extensions,找到autoDocstring→ 点击齿轮图标 →Disable - 如果是 JavaScript/TypeScript,大概率是
Document This或 TS 语言服务器自带行为:先确认是否装了Document This;若没装却仍有/**回车生成模板,那是 TypeScript 插件默认行为,无法关闭,只能换语言模式(比如临时切到Plain Text)再编辑
误触发后怎么快速清理已插入的注释?
刚按完 /** 回车又反悔了,别一行行删。用 VS Code 内置的「撤销注释操作」:
- 保持光标在刚生成的注释块内(任意位置)
- 按
Ctrl+Shift+P打开命令面板,输入Toggle Line Comment并回车 —— 它会把整个注释块当普通代码行处理,加一层//,再按一次就还原(本质是利用注释嵌套失效的 trick) - 更稳妥的是直接
Ctrl+Z,只要没做其他编辑,通常能一步撤回整块模板
容易被忽略的隐藏依赖
有些项目根目录下有 .vscode/settings.json,里面可能写了 "editor.suggest.snippetsPreventQuickSuggestions": false 或自定义的 editor.quickSuggestions,这会影响 /** 触发时机;另外,Prettier、ESLint 等格式化插件有时会在保存时重排注释结构,造成“模板又回来了”的错觉——实际是格式化规则把空注释块补全了。


















