Sublime Text折叠失效主因是语法识别错误或配置干扰；需先确认右下角语法名是否正确，再禁用折叠插件、清理fold相关设置，检查缩进/括号匹配，并通过show_scope_name验证作用域识别。
Sublime Text 里 fold 函数不生效？先确认语法高亮是否正确
Sublime 的代码折叠依赖当前文件的语法定义（syntax definition），不是所有语言都默认支持块级折叠。比如纯文本或未识别的后缀名（如 .sh、.conf）可能只支持行注释折叠，不支持 if、function 等结构折叠。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: XXX，手动选对语法（如JavaScript、Python） - 检查右下角状态栏是否显示了正确的语法名；若显示
Plain Text，折叠基本不可用 - 某些自定义语法包（如
Vue Syntax Highlight）需额外启用折叠支持，查看其 README 是否提到fold_level或fold_expression
折叠快捷键失效或只折一行？检查是否启用了「自动折叠」干扰
Sublime 默认不自动折叠，但用户常误装插件（如 AutoFold、CodeFolding）或修改了 Preferences.sublime-settings，导致行为异常：比如一打开就全折叠、光标移动时意外展开、或 Ctrl+Shift+[ 只折叠当前行而非代码块。
实操建议：
- 禁用可疑插件：菜单 →
Preferences → Package Control → Disable Package，逐个关掉折叠类插件再测试原生快捷键 - 检查设置项：
Preferences → Settings中搜索fold，删掉或注释掉类似"fold_on_open": true、"fold_buttons": false这类非默认配置 - 原生折叠快捷键是：
Ctrl+Shift+[（折叠）、Ctrl+Shift+]（展开）、Ctrl+K Ctrl+1~9（按缩进层级折叠）——注意不是Ctrl+K Ctrl+0（那是全部展开）
Python/JS 里 def 或 function 折不了？看缩进和括号是否被语法识别为“可折叠范围”
Sublime 的折叠逻辑分两类：基于缩进（如 Python）和基于括号匹配（如 JS、JSON）。如果某段代码没被识别为有效作用域，就不会折叠。常见于：
- Python 中混用了空格和 Tab，导致缩进层级错乱，
def块无法被归为同一折叠单元 - JavaScript 中函数写成箭头函数且无大括号：
const fn = () => console.log(1)—— 这种单表达式形式不会被折叠 - JSX 或模板字符串中出现未闭合的
{，会破坏括号匹配，连带影响后续函数折叠 - 检查方式：把光标放在
def或function行，按Ctrl+Shift+P输入show_scope_name，看输出里是否有meta.function或meta.class；没有就说明语法解析失败
自定义折叠规则？改 .sublime-syntax 文件比想象中容易，但别动系统文件
想让 ### TODO 或 /* SECTION */ 这类标记也能折叠？得写自定义折叠规则，但别直接改 Sublime 自带的 Python.sublime-syntax —— 升级后会被覆盖。
实操建议：
- 新建一个
MyPython.sublime-syntax文件，放在Packages/User/目录下（通过Preferences → Browse Packages打开） - 在其中复用原语法定义，只加一段
fold:规则，例如：
- match: '(?i)^\s*#\s*===.*$' fold: true
Settings 里加："syntaxes": [{"syntax": "Packages/User/MyPython.sublime-syntax", "extensions": ["py"]}]
^ 和 $ 在 Sublime 语法里按行匹配，不要加 re.MULTILINE 类标志真正麻烦的是调试折叠规则——改完要重启 Sublime 或用 Ctrl+Shift+P → Satisfy Dependencies 刷新语法缓存，而且错误不会报红，只会“没反应”。多试几次 show_scope_name 和快捷键，比硬猜快得多。
