sublime text 默认仅支持括号结构折叠，需启用 "fold_by_level": true 并确保语法定义支持语义层级折叠（如官方 python/html），否则仅能按缩进折叠。
Sublime Text 默认不按语法层级折叠，得手动开开关
Sublime Text 默认只对 {}、[]、() 这类括号结构做基础折叠，HTML 标签、Python 的 def/class、CSS 块这些「语义层级」默认不参与折叠。这不是 bug，是设计如此——它把折叠逻辑交给语法定义（即 .sublime-syntax 或旧版 .tmLanguage 文件）控制。
实操建议：
- 打开 Preferences → Settings – Syntax Specific，在右侧 JSON 中加：
"fold_by_level": true
- 或者全局启用（谨慎）：在 Preferences → Settings 里加同一行，但会影响所有语言，部分语法定义不支持该选项时会失效
- 确认当前文件绑定的语法正确：右下角点开语法名（如 “Plain Text”），选对应语言（如 “Python”、“HTML”），否则
fold_by_level不生效
Python / HTML / CSS 折叠不工作？检查语法定义是否支持 fold_by_level
不是所有语言包都实现了层级折叠规则。比如官方 Python 语法支持 def、class、if 等缩进块折叠；但某些第三方 HTML 语法或老旧包可能只认 <div> 开闭标签，不识别 <code><template></template> 或 JSX 风格写法。
常见错误现象：
- 按
Ctrl+Shift+[没反应，或只折了缩进、没折def块 - HTML 中
<script></script>内 JS 代码能折，但外层<div> 折不了 <li>开启 <code>fold_by_level后，CSS 的@media块不折叠，但选择器块可以 - 用官方语言包（如 Sublime Text 4 自带的 Python / HTML）基本可靠；避免用已停更的第三方
.tmLanguage - 检查语法文件里有没有
fold相关 scope 定义：打开 Tools → Developer → Show Scope Name，把光标放在想折叠的结构上（如def foo():），看输出里是否含meta.function.python这类可折叠 scope - 不支持的语法，可临时切到
Plain Text，靠缩进折叠（需确保detect_indentation为true） - 误以为开了
fold_buttons: true就等于支持层级折叠 —— 实际只是显示按钮，没fold_by_level还是只能折括号 - 在用户设置里写了
"fold_by_level": true，但语法设置里又写了"fold_by_level": false，后者会覆盖前者 - 用插件（如
CodeFolding）时，它可能自行接管折叠逻辑，导致原生fold_by_level失效 -
Ctrl+K, Ctrl+1~9是按缩进层级折叠（1=折所有一级缩进，9=最细粒度），和fold_by_level无关，纯靠空格/TAB 判断 - 鼠标点击行号左侧的横线（非箭头）可手动折叠当前行所在逻辑块，前提是该行属于一个可折叠 scope（用
Show Scope Name验证） - 折叠后按
Ctrl+Shift+]展开，但若展开不完全（比如只展一层），说明当前结构被多个嵌套 scope 包裹，需多按几次
解决路径：
fold_by_level 和 fold_enable、fold_buttons 的关系别搞混
这三个配置共存但分工明确：fold_enable 是总开关（默认 true），关了它一切折叠都无效；fold_buttons 控制左侧折叠小箭头显隐（不影响快捷键）；而 fold_by_level 是唯一决定「是否按语法层级折叠」的参数。
容易踩的坑：
快捷键和鼠标操作要匹配当前折叠模式
Sublime 的折叠快捷键本身不区分「括号折叠」还是「层级折叠」，但效果取决于底层是否启用 fold_by_level。比如 Ctrl+Shift+[ 在 Python 里，开了 fold_by_level 会优先折 def 块；没开就只折最内层 : 后缩进区。
实操要点：
层级折叠真正起作用的地方，往往不在“能不能折”，而在“折得是不是你心里想的那个块”——scope 定义稍有偏差，光标一放错位置，就折出意料之外的结果。
