Sublime Text 本身不支持调试，仅能配置语法高亮、静态检查、格式化和一键运行；所谓“调试插件”多为误传，真断点调试需换用 VS Code + lua-debug 或 ZeroBrane Studio。
Sublime Text 本身不支持调试（debug），所谓“调试插件”基本是误传或功能夸大——它没有断点、变量监视、单步执行等调试能力。你真正能装的，只有语法高亮、格式化、静态检查和一键运行这四类工具。
为什么找不到靠谱的 Lua 调试插件
Sublime Text 的 API 不开放调试器集成接口，所有标榜“调试”的插件（比如 SublimeDebugger 或带 debug 字样的 Lua 包）要么是改名混淆的旧版代码补全工具，要么依赖外部终端手动加 print 或 debug.debug() —— 它们不提供真调试界面。Lua 标准库里的 debug 模块在多数游戏沙箱（Roblox/WoW）或 Nginx 中还被禁用，硬接也跑不通。
- 真正能用的“调试辅助”只有两类：静态检查（提前发现未定义变量、全局污染）和运行日志（
Ctrl+B看输出） - 如果你需要断点调试，得换工具：VS Code +
lua-debug扩展，或用 ZeroBrane Studio（专为 Lua 设计，支持远程 attach） - 别在 Package Control 里搜 “debug lua” 或 “lua debugger”，大概率装到废弃包（如
lua-sublime），反而破坏语法高亮
必须装的三个实际可用扩展
这些不是“调试插件”，但能大幅减少调试成本：早发现问题、自动排版、避免低级错误。
-
Lua Enhanced：唯一推荐的语法包。右下角语言切换后显示 “Lua Enhanced”，支持do...end匹配、[[...]]多行字符串着色、正确缩进。别装Lua（官方旧包）或AutoLua（补全失效多年） -
SublimeLinter-lua+luacheck：前者是 Sublime 接口，后者是命令行工具。需先luacheck --no-global your_file.lua验证本地能跑，再装插件。它会标出undefined global 'game'这类 Roblox/WoW 常见错误 -
Pretty Lua：基于stylua的格式化工具。安装后必须手动配置binary路径（指向你下载的stylua.exe或stylua可执行文件），否则快捷键ctrl+alt+shift+l按下没反应
Ctrl+B 运行失败：常见报错与修复
lua: command not found 或 luajit: command not found 是最常卡住的一步。这不是插件问题，而是构建系统找不到解释器。
- 先在终端确认：
lua -v或luajit -v有输出；没有就去官网下 LuaJIT（Windows）或用brew install luajit（macOS） - PATH 要生效：Windows 加完环境变量后重启 Sublime；macOS/Linux 若从桌面图标启动，PATH 可能丢失，改用终端执行
subl启动编辑器 - 构建文件
lua.sublime-build必须存放在Packages/User/目录下，内容里"cmd"要匹配你实际用的命令（["lua", "$file"]还是["luajit", "$file"]） - 别把构建文件名写成
lua_build.json或漏掉.sublime-build后缀，Sublime 不识别
最容易被忽略的是环境继承问题：Sublime 从桌面启动时，往往拿不到 shell 里配置的 PATH，导致 Ctrl+B 找不到 lua。验证方式很简单——打开 Sublime 控制台（Ctrl+`），输入 import os; print(os.environ.get('PATH'))，看输出里有没有你的 Lua 安装路径。
