Sublime Text需先绑定Lua语法并安装Lua Enhanced插件实现高亮，再配置Lua.sublime-build构建系统才能运行脚本；lua命令须在终端可用，且构建文件中必须包含"selector":"source.lua"。
Sublime Text 本身不运行 Lua，也不自带语法支持；所谓“插件”，实际分两类：一类管高亮和编辑体验（如 Lua Enhanced），另一类管构建和运行（靠 .sublime-build 文件，不是插件）。很多问题卡在混淆这两者，结果装了一堆插件却 Ctrl+B 没反应。
怎么让 .lua 文件有语法高亮和基础编辑功能
默认安装的 Sublime 打开 .lua 文件是 Plain Text，关键字不着色、括号不匹配、缩进乱套——这不是配置错了，是压根没加载 Lua 语言定义。
- 最简方案：打开任意
.lua文件 → 点右下角语言名（比如 “Plain Text”）→ 选Lua。这会把当前文件和所有同后缀文件绑定到内置 Lua 包（如果存在） - 若列表里没有
Lua，说明内置包缺失，需装插件：Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜Lua Enhanced（推荐，支持require跳转、注释折叠、do/end匹配） - 别装名字带
sublime或lua-completion的废弃包，容易冲突；装完重启或重开文件才能生效
为什么装了插件还是 Ctrl+B 报 lua: command not found
报这个错，90% 和插件无关，只说明 Sublime 构建系统找不到 lua 命令——它根本没去查插件，只查你系统的 PATH。
- 先在终端执行
lua -v：能输出类似Lua 5.4.6才算通过；Windows 上用where lua，macOS/Linux 用which lua - Windows 常见坑：
lua.exe在C:\lua\，但没加进系统环境变量PATH；或者路径含空格（如C:\Program Files\Lua\），得写成["C:/lua/lua.exe", "$file"]（用正斜杠防转义） - macOS GUI 启动的 Sublime 可能读不到 shell 的
PATH，比如brew install lua装在/opt/homebrew/bin/lua，就得在构建系统里写死绝对路径 - Linux 很多发行版默认命令是
lua5.4而非lua，cmd字段必须跟which lua5.4输出一致
怎么写对 Lua.sublime-build 文件
这个 JSON 文件容错率极低，一个标点错就静默失效（Ctrl+B 没反应，也不报错）。
- 必须用英文引号，末尾逗号不能少，缩进用 4 个空格（别用 Tab）
-
"cmd": ["lua", "$file"]是最简有效形式；"shell_cmd"写法（如"shell_cmd": "lua \"$file\""）在 Windows 下易因引号嵌套失败，不推荐 -
"selector": "source.lua"是硬性要求——缺了它，Sublime 根本不会为.lua文件启用该构建系统；如果你装了Lua Enhanced，它注册的是source.lua.enhanced，这里就得同步改成对应值 -
"file_regex"决定错误点击能否跳转：Lua 默认报错格式是test.lua:5: attempt to call a nil value，正则用"^(*?):([0-9]+):?([0-9]*):? (.*)$"即可；luajit错误末尾可能带列号（如:5:12），就得改成"^(.*?):([0-9]+):([0-9]+):"
中文路径、io.read() 和闪退问题怎么解
这些不是 Sublime 的 bug，而是子进程启动时的编码与 stdin 限制导致的。
- Windows 下中文路径报
cannot open xxx: No such file or directory：本质是 Sublime 用 GBK 编码传路径，而lua.exe（尤其 5.4+）按 UTF-8 解析，中间一转就丢字；最稳方案是把项目移到纯英文路径（如C:/lua-test/） -
io.read()或交互输入会导致构建面板卡住或闪退：Sublime 输出面板不支持 stdin 输入，此时应改用终端运行；非要留在 Sublime 里，可在构建系统加"target": "exec"并设"shell": true，但仍有局限 - 脚本里打印中文变问号：不是构建系统问题，是 Lua 自身编码逻辑；
io.open("中文.txt", "r", ":utf8")（仅 Lua 5.4+ 支持）比依赖系统 locale 更可靠
真正卡住人的地方，从来不是插件装多少，而是 lua -v 能不能跑通、.sublime-build 的 JSON 有没有多逗号、右下角状态栏有没有显示 Lua——三者缺一不可。路径和编码问题最容易被当成“玄学”，其实只要挪到英文目录下试一次，立刻就能验证是不是这个原因。
