fold_level是fold_by_level命令的参数，表示手动触发时折叠所有缩进深度≤N的代码块；它不控制启动自动折叠，Sublime默认不自动折叠任何内容。
Sublime Text 中 fold_level 的实际作用是什么
fold_level 并不是全局“默认折叠层级”的开关，而是 fold_by_level 命令执行时的参数——它只在你手动触发折叠（比如按 Ctrl+K, Ctrl+1）时生效，表示“把所有缩进深度 ≤ N 的代码块全部折叠”。它不控制启动时自动折叠，也不影响鼠标点击折叠控件的行为。
常见误解是改了 fold_level 就能让文件一打开就收起函数或类，但 Sublime 默认根本不自动折叠任何内容，除非你明确配置了 fold_on_open 或使用插件干预。
如何让文件打开时自动折叠指定层级（如函数/类）
Sublime 原生不支持“按语法结构自动折叠”，但可通过组合设置逼近效果：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
"fold_on_open": true：启用后，仅对有明显折叠标记（如/*{{{*/）或语言自带折叠规则（如 Python 的 class/function 缩进块）的文件生效；对 JS/TS 等依赖语法树的文件基本无效 -
"fold_enable_auto": true（非官方配置项，无效）：这个键根本不存在，别在设置里写它 - 真正起效的是语言专属的
fold规则：例如 Python 语法定义中已内置fold指令匹配def和class行；而 JavaScript 则依赖scope:source.js对应的.sublime-syntax文件是否包含fold指令 - 若发现某语言不自动折叠函数，优先检查是否用了第三方语法包（如 Babel），它可能覆盖了原生折叠逻辑
修改折叠行为必须动的两个文件位置
折叠逻辑由语法定义驱动，关键路径只有两处：
- 原生语法文件：
Packages/Python/Python.sublime-syntax（直接搜索fold:可看到 class/def 折叠规则） - 用户自定义覆盖：
Packages/User/Python.sublime-syntax（新建同名文件可 patch 折叠逻辑，但需 YAML 格式和正确 scope 引用） - 不要去改
Preferences.sublime-settings试图控制折叠结构——它只管 UI 行为（如是否显示折叠图标、动画速度），不管“哪些代码该被识别为可折叠块” - 插件如
CodeFold或Origami是另一条路，但它们不修改语法层，而是基于正则或 AST 临时计算，稳定性不如原生语法折叠
调试折叠失效的三步检查法
当点击代码左侧空白没反应，或 Ctrl+Shift+[ 没反应，按顺序确认：
- 当前文件是否被正确识别为对应语言？看窗口右下角，显示
Python而非Plain Text；错误识别会导致语法折叠规则完全不加载 - 执行
Ctrl+Shift+P→ 输入Set Syntax，选回原生语法（如Python），排除第三方语法包干扰 - 打开命令面板运行
show_scope_name，把光标放在想折叠的函数名上，确认输出含meta.function.python这类带meta.前缀的 scope —— 只有带meta.的节点才可能被折叠规则捕获
折叠不是“设置调大就变多”，而是“语法定义说哪段是块，Sublime 才认哪段能折”。很多问题根源不在设置，而在当前文件压根没被当成目标语言解析。
