应安装 luaformat 插件,它专为 lua 设计、自带格式化引擎、不依赖外部环境;通过 package control 搜索“lua format”安装,确保语法设为 lua,键绑定设为 {"keys": ["ctrl+alt+f"], "command": "lua_format"}。

装什么插件?别用通用格式器,直接上 LuaFormat
Sublime Text 本身不支持 Lua 格式化,LuaFormat 是目前最稳定、专为 Lua 设计的插件,不依赖 Node.js 或 Python 环境,也不调用外部 CLI 工具——它自带格式化引擎,装完即用。
别乱试 Sublime-Code-Formatter 或 JsPrettier,它们根本不识别 .lua 后缀,配置了也白配。
怎么装和启用?Package Control 搜 “Lua Format” 就对了
打开 Ctrl+Shift+P → 输入 Install Package → 回车 → 等列表加载完 → 输入 Lua Format(注意空格,不是 LuaFormat 或 luafmt)→ 选中安装。
装完不用重启,但得确认右下角语法标识已变成 Lua:点一下右下角文字,手动选 Lua;如果是 Plain Text,格式化命令根本不会触发。
快捷键怎么设?默认是 Ctrl+Alt+F,但容易被占用
进 Preferences → Key Bindings,在右侧用户键绑定里加这一行:
[{"keys": ["ctrl+alt+f"], "command": "lua_format"}]
常见踩坑点:
-
ctrl+alt+f在部分 Windows 系统或远程桌面里会被系统截获,换成ctrl+shift+f更稳 - 如果按了没反应,打开控制台
Ctrl+`看有没有command not found: lua_format—— 那说明插件没装成功,或者文件没设成 Lua 语法 - 别把键绑定写错成
"command": "luaformat"(少下划线)或"lua_formater"(拼错),命令名必须严格匹配lua_format
自动保存时格式化?关掉更安全
LuaFormat 默认不支持 on_save,强行在设置里加 "auto_format_on_save": true 可能导致大文件卡顿,或误格式化生成代码(比如 Cocos-Lua 项目里混着 tolua++ 生成的 Lua 文件)。
真实协作中,Lua 项目往往靠 lua-format CLI 做 CI 检查,编辑器只负责手动精修。建议就用手动快捷键,选中一段函数再按 Ctrl+Alt+F,避免改到注释块或字符串里的换行。











