sublime需正确识别语言作用域才能折叠函数，验证方法为光标置于def行后执行show_scope_name命令；批量折叠函数应使用fold_by_level命令并实测作用域层级数字，而非缩进折叠。
Sublime 默认不支持“只折函数”，得靠作用域识别
Sublime 的折叠逻辑基于语法作用域（scope），不是简单数缩进或找 def 关键字。它默认能折函数，但前提是：文件被正确识别为对应语言（右下角显示 Python，不是 Plain Text），且语法定义里声明了 foldingStartMarker 和 foldingStopMarker。很多用户点了 Ctrl+Shift+[ 没反应，第一反应是快捷键错了，其实大概率是语言没切对。
验证方法：光标放在一个 def 行，按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 show_scope_name 回车，状态栏若显示类似 source.python meta.function.python，说明函数作用域已识别；如果只有 source.python，说明语法高亮失效或插件冲突。
怎么批量折叠所有函数定义（非缩进式）
不能依赖 Ctrl+K Ctrl+0 或菜单里的 Fold All——它们按缩进层级折叠，会把 if、for、甚至注释块也一起收进去，不是你想要的“仅函数”。
真正可靠的做法是用命令面板调用 fold_by_level 并指定函数级作用域对应的层级数字：
- 先手动用
Ctrl+Shift+[折叠一个函数，确认它真的被识别为函数块 - 按
Ctrl+Shift+P→ 输入fold_by_level→ 回车 - 输入数字（Python 通常是
2，JavaScript 常是3，但必须实测） - 如果输错，不会报错，只是没反应——换 1、2、3、4 逐个试一遍
这个数字不是语言固定值，而是当前语法文件里 meta.function 所在的作用域嵌套深度。不同插件或自定义语法包可能改变它。
常见失效场景和绕过方式
以下情况会导致函数无法折叠，即使语法正确：
-
def my_func():后紧接 docstring 且没换行，比如def f(): """doc"""; pass→ Sublime 可能跳过整个块，改成换行写或加空行 - 用了非标准写法，如装饰器跨多行、
@overload后无函数体，或类型提示过长导致解析中断 - 安装了自定义语法插件（如某些 Vue/TS 插件），但其
.sublime-syntax文件未定义折叠规则 - 文件后缀不标准（如
.pyi、.j2），Sublime 没自动绑定语法，需手动切换
临时补救：选中所有 def 行（可用 Ctrl+F 搜 ^def ，勾选正则和行首），然后按 Ctrl+Shift+[ —— 这会以选区为锚点，对每个匹配行触发一次折叠。
折叠按钮不显示？检查两个设置项
左侧边栏没出现小三角图标，通常不是功能关闭，而是视觉隐藏或配置缺失：
- 打开
Preferences → Settings，确保用户设置里有"fold_buttons": true - 如果按钮一闪就消失，加一行
"fade_fold_buttons": false，让它常驻显示 - 注意：这个设置只控制按钮可见性，不影响快捷键或命令面板操作
真正容易被忽略的是作用域识别失败这个前提——按钮不显示，90% 情况下是因为 Sublime 根本没把那段代码当成函数，而不是界面设置问题。
