You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何配置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插件把折叠和展开注释的操作合并成一个快捷键:
    1. 安装Multi Command插件
    2. 在settings.json里添加宏配置:
    "multiCommand.commands": [
      {
        "command": "multiCommand.foldAndKeepComments",
        "sequence": [
          "editor.foldLevel2", // 替换成你常用的层级,比如foldLevel1、foldLevel3
          "editor.unfoldAllComments"
        ]
      }
    ]
    
    1. 回到快捷键设置,给这个宏绑定你习惯的折叠快捷键(比如替换原来的Ctrl+K, Ctrl+2),这样按一次快捷键就能完成折叠指定层级+展开注释的操作。

内容的提问来源于stack exchange,提问作者Ximu_Luya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.07 10:00:52