如何通过Sublime Text一键折叠所有注释，快速隐藏源码中的说明文字？

本文共计626个文字，预计阅读时间需要3分钟。

仅对以下进行操作：

• 启用 fold_comments 设置（仅对部分语言有效）：在当前文件的语法专属设置里（Preferences → Settings – Syntax Specific）加一行：

  "fold_comments": true适用于 Python（# 开头）、JavaScript（// 和 /* */）、C/C++ 等，但对 #region 类注释无效

• 自定义 .sublime-syntax 规则（通用但门槛高）：需在语法定义中添加 fold: true 的正则匹配块，例如匹配 // #region 到 // #endregion 之间的内容；常见坑包括正则未开启 dotall 模式、路径写错（应放在 Packages/User/ 下）、漏掉 scope: comment.line.double-slash 等上下文限定

替代方案：用缩进层级 + 空行模拟“注释折叠”

如果不想碰语法文件，更轻量的做法是统一格式化注释块：

• 每段说明前加空行 + 一致缩进（比如全部顶格或统一缩进 2 空格）
• 在用户设置（Preferences → Settings）中启用：

  "fold_by_level": true

• 再用 Ctrl+K, Ctrl+2 折叠到第二级缩进——此时顶格的代码保留，缩进的注释块会被收起
• 注意：该法会同时折叠所有同级缩进内容（比如函数体内的注释和代码一起折），不是纯“只折注释”

为什么 Ctrl+K, Ctrl+J 展不开你手写的注释块

因为展开操作依赖折叠时的生成逻辑。如果你用的是手动选中 + Ctrl+Shift+[ 折叠的注释块，Ctrl+K, Ctrl+J 能正常展开；但如果是靠 fold_comments: true 或自定义语法规则实现的折叠，展开行为取决于规则是否定义了对应的 unfold 边界——很多正则规则只定义了“开始”，没配“结束”，结果就是能折不能展，或者展开后光标跳位。

最易被忽略的一点：折叠注释从来不是“开个开关就行”的功能，它本质上是在修改 Sublime 对“代码结构”的理解边界。一旦改语法，就得同步考虑高亮、跳转、查找等其他功能是否受影响。