lua文件默认不支持代码折叠是因为官方语法包未定义foldingstartmarker，quickxdev插件通过重写语法定义并添加关键字行标记解决该问题，配合foldonload.py插件可实现自动折叠。
为什么Lua文件默认不支持代码折叠
Sublime Text 的代码折叠能力完全依赖语法定义（syntax definition），而官方自带的 Lua 语法包（LaTeXTools 或旧版 Lua）未声明 foldingStartMarker，导致 function、if、do 等关键字行无法触发折叠。你按 Ctrl+Shift+[ 没反应，不是快捷键错了，也不是插件没装——是 Lua 语法本身没告诉 Sublime “这一行可以折”。
用 QuickXDev 插件补全折叠支持
QuickXDev 是目前最适配 Lua 的 Sublime 插件，它重写了 Lua 语法定义，并在 function、if、for、while、do、repeat 行添加了 foldingStartMarker，同时兼容 Quick-Cocos2d-x 和标准 Lua 5.1–5.4。
- 从 GitHub 下载最新版
QuickXDev压缩包（注意：不是 Package Control 里同名但已停更的旧插件） - 解压后将整个文件夹放入
Packages/QuickXDev（路径：Sublime Text 3/Packages/QuickXDev） - 重启 Sublime，打开一个
.lua文件，右下角状态栏应显示QuickXDev或Lua (QuickXDev)，而非Plain Text或原生Lua - 确认光标停在
function foo()行，按Ctrl+Shift+[应立即折叠其函数体
手动启用自动折叠（非默认行为）
即使语法支持了，Sublime 也不会“打开文件就自动折叠”——这是常见误解。"fold_by_default": true 在用户设置中无效，必须用事件监听插件。
- 菜单栏 →
Tools→Developer→New Plugin… - 替换全部内容为：
import sublime
import sublime_plugin
class FoldOnLoadListener(sublime_plugin.EventListener):
def on_load_async(self, view):
if view.score_selector(0, "source.lua") > 0:
view.run_command("fold_all")
- 保存为
FoldOnLoad.py（路径必须是Packages/User/FoldOnLoad.py） - 注意：该插件只对新打开的 Lua 文件生效；已打开的文件需手动执行
Ctrl+K, Ctrl+0 - 若想只折函数不折
if块，得改用fold_by_level并实测层级——通常 Lua 中function在 level 1，if在 level 2
折叠失效时快速排查三件事
别急着重装插件，先看这三项：
- 右下角是否显示
QuickXDev？显示Lua或Plain Text就说明语法没切过去，点击它手动选 - 文件是否已保存且扩展名为
.lua？未保存的临时文件不会触发语法关联 - 是否误启用了冲突插件？比如旧版
SublimeLua或EnhancedLua，它们会覆盖语法定义，临时禁用后测试
折叠按钮（侧边栏 ▶）不出现？检查用户设置里是否有 "fold_buttons": true，没有就加上；如果被其他插件写成 false，删掉那行或改成 true。
