根本原因是系统未安装Lua解释器或未将其加入PATH环境变量，Sublime仅调用命令行lua命令；需先验证lua -v，再按系统正确安装并配置PATH，同时确保Build System语法严格正确、路径编码统一为UTF-8。
Sublime Text 里直接按 Ctrl+B 运行 Lua 报错 lua: command not found
根本原因不是 Sublime 本身的问题，而是系统没装 Lua 解释器，或者没加进环境变量 PATH。Sublime 的 Build System 只是调用命令行里的 lua 命令，它自己不带运行时。
实操建议：
- 先在终端（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal）里执行
lua -v，看是否返回版本号；如果报command not found或'lua' 不是内部或外部命令，说明 Lua 没装好 - Windows 用户推荐去 LuaBinaries 下载预编译的
lua-5.4.x_Win64_bin.zip，解压后把含lua.exe的文件夹路径加到系统环境变量PATH中 - macOS 用户用 Homebrew 安装最稳：
brew install lua；M1/M2 芯片注意别装错架构（brew install lua@5.4更可控） - Linux（如 Ubuntu）用
sudo apt install lua5.4，再建个软链接：sudo ln -sf /usr/bin/lua5.4 /usr/local/bin/lua，否则 Sublime 找不到默认lua
Sublime 的 Lua Build System 配置文件写不对，保存后没反应
Build System 是 JSON 格式，但 Sublime 对语法错误容忍度极低——多一个逗号、少一个引号、缩进用 tab 而非空格，都会导致整个配置失效，且不报错，只是 Ctrl+B 后静默失败。
实操建议：
- 新建 Build System：菜单 → Tools → Build System → New Build System…，粘贴以下内容（注意全部用英文引号、逗号结尾、4 空格缩进）：
{
"cmd": ["lua", "$file"],
"selector": "source.lua",
"file_regex": "^(...*?):([0-9]*):?([0-9]*):? (.*)$",
"working_dir": "$file_path"
}
-
"selector": "source.lua"必须存在，否则 Sublime 不知道该不该对.lua文件启用这个构建；如果你用的是 Lua 插件（如 Lua Enhanced），它可能注册了不同的 scope，此时要改成"selector": "source.lua.enhanced" - 保存为
lua.sublime-build，放在Packages/User/目录下（可通过 Preferences → Browse Packages… 打开） - 保存后务必重启 Sublime，或手动刷新 Build System 列表：菜单 → Tools → Build System → Refresh Projects
中文路径或文件名下运行 Lua 报错 cannot open xxx: No such file or directory
这是 Windows 上最典型的编码陷阱：Sublime 默认用系统 ANSI 编码（如 GBK）读取文件路径，但 lua.exe 在 5.4 之前只认 UTF-8 路径，两者一碰就丢字符，路径解析失败。
实操建议：
- 最简单方案：把项目和文件全移到纯英文路径下，比如
C:/dev/hello.lua，立刻解决 - 若必须用中文路径，Windows 用户可尝试改用
lua54.exe（Lua 5.4+），它原生支持 UTF-8 路径；同时确保 Sublime 的encoding设为 UTF-8（右下角状态栏点一下，选 UTF-8） - Mac/Linux 用户一般无此问题，但若用 NFS 或某些挂载卷，也可能触发路径编码异常，此时优先检查
pwd输出是否含乱码
想传参数给 Lua 脚本，比如 lua main.lua arg1 arg2，但 Sublime 默认不支持
Sublime 的 cmd 字段是静态数组，不支持交互式输入或动态参数拼接。硬改 "cmd": ["lua", "$file", "hello", "world"] 虽能跑，但每次改参数都要手动编辑 build 文件，失去灵活性。
实操建议：
- 临时方案：用 Sublime 的 Build with… 功能。先保存上面那个基础 build，然后按
Ctrl+Shift+P→ 输入 Build With → 回车 → 选择你的 Lua build → 再输入参数，例如：arg1 arg2（注意不要加lua或文件名，Sublime 已自动补全） - 长期方案：写个轻量 wrapper 脚本，比如
runlua.bat（Win）或runlua.sh（macOS/Linux），里面接收参数并调用lua "$1" %2 %3 %4，然后在 build 文件里把"cmd"改成调用这个脚本 - 注意：Sublime 的
$file是绝对路径，含空格时会被拆成多个参数，所以 wrapper 脚本里一定要用引号包住，比如lua "$1" "${@:2}"（bash）或lua "%~1" %2 %3（bat）
