如何配置VSCode,折叠代码时不折叠jsDoc等块注释?
VSCode折叠指定层级代码时保留多行注释的解决方案
一、内置设置调整
- 打开VSCode设置(快捷键
Ctrl+,),搜索editor.foldingStrategy,将值从auto改为indentation。这个设置会让编辑器只根据缩进层级折叠代码,不会把块注释当作折叠节点,用Ctrl+K, Ctrl+数字折叠时,多行注释会保持展开状态。 - 如果需要更精细控制,可修改
editor.foldableRegex,移除匹配jsDoc块注释的规则(比如排除\/\*\*[\s\S]*?\*\/这类格式),不过一般第一个设置就足够解决问题。
二、插件解决方案
- Custom Folding:这款插件支持自定义折叠规则,你可以在插件设置里配置排除多行注释的折叠触发,让编辑器忽略jsDoc注释的折叠逻辑。
- Fold Level:它能更精准控制折叠层级,还支持排除特定节点类型,开启插件设置里的“排除块注释”选项即可。
三、自定义快捷键组合
- VSCode没有默认的“展开所有块注释”快捷键,但可以自己配置:打开快捷键设置(
Ctrl+K, Ctrl+S),搜索editor.unfoldAllComments,给它绑定一个快捷键(比如Ctrl+K, Ctrl+Shift+/)。这样折叠完代码后,一键就能展开所有注释。 - 也可以用
Multi Command插件把折叠和展开注释的操作合并成一个快捷键:- 安装
Multi Command插件 - 在
settings.json里添加宏配置:
"multiCommand.commands": [ { "command": "multiCommand.foldAndKeepComments", "sequence": [ "editor.foldLevel2", // 替换成你常用的层级,比如foldLevel1、foldLevel3 "editor.unfoldAllComments" ] } ]- 回到快捷键设置,给这个宏绑定你习惯的折叠快捷键(比如替换原来的
Ctrl+K, Ctrl+2),这样按一次快捷键就能完成折叠指定层级+展开注释的操作。
- 安装
内容的提问来源于stack exchange,提问作者Ximu_Luya
相关产品推荐
相关产品推荐

