sublime需安装lua插件实现语法高亮，配置build system并确保lua解释器在path中才能运行脚本；中文路径问题需避免或显式指定utf-8编码；sublime无内置调试功能，调试应换用专业工具。
怎么让 Sublime 识别 .lua 文件并高亮语法
Sublime 默认不带 Lua 支持，打开 .lua 文件就是纯文本——连关键字都不变色。这不是配置错了，是压根没装语言定义。
实操建议：
- 用
Package Control安装Lua插件（不是SublimeLinter-lua或lua-completion，就叫Lua） - 安装后，打开任意
.lua文件 → 点右下角语言名（比如 “Plain Text”）→ 选Lua；之后可按Ctrl+Shift+P输入Set Syntax: Lua快速切换 - 如果点开还是没高亮，检查是否误装了名字相近的废弃包（如
lua-sublime），卸载干净再重装
为什么 Build System 选了 Lua 却运行报错 'lua' is not recognized
这是最常卡住人的一步：Sublime 的构建系统只是调个命令行，它不管你的 Lua 解释器装没装、在不在 PATH 里。
实操建议：
- 先在终端（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal）里运行
lua -v，能输出版本才说明环境就绪 - 如果报错，去 lua.org 下对应系统的二进制（Windows 推荐
lua-5.4.x_Win64_bin.zip，解压后把lua.exe所在目录加进系统PATH） - 重启 Sublime（不重启，它读不到新
PATH） - 再建一个 Build System：
Tools → Build System → New Build System，填入：{ "cmd": ["lua", "$file"], "selector": "source.lua", "file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$" }保存为
Lua.sublime-build，之后就能用Ctrl+B运行当前文件了
运行含中文路径或参数的 Lua 脚本时崩溃或乱码怎么办
Windows 下尤其明显：路径带中文，os.execute 失败；打印中文变问号；甚至 Sublime 直接无响应。这不是 Lua 问题，是 Sublime 构建系统默认用系统编码启动进程，而 Windows 控制台默认是 GBK，Lua 5.4+ 默认按 UTF-8 解析字符串。
实操建议：
- 避免中文路径——把项目移到
C:/lua-test/这类纯英文路径下，一劳永逸 - 如果必须处理中文，改用
io.open显式指定编码：io.open("文件.txt", "r", ":utf8")（仅 Lua 5.4+ 支持） - 构建系统里加
"encoding": "UTF-8"字段，但注意：这仅影响 Sublime 捕获输出的解码方式，不改变子进程内部编码逻辑 - 别依赖
os.getenv("USERPROFILE")拼路径——Windows 用户目录名是中文时，这里返回的就是乱码，改用os.getenv("HOMEDRIVE")..os.getenv("HOMEPATH")
想调试 Lua（断点、变量查看）能不能在 Sublime 里实现
不能。Sublime 是纯编辑器，没有内置调试器，也没有官方支持的 Lua 调试插件。所谓“Sublime 调试 Lua”的教程，基本都是拿 print 或 debug.debug() 手动打桩，或者外挂 VS Code + lua-debug 反向操作。
实操建议：
- 接受现实：Sublime 就是用来写、看、快速跑脚本的；真要调试，换工具更省时间
- 如果坚持用 Sublime，可在关键位置插入
print(debug.traceback())或print(tonumber(a), type(b))辅助定位 - 不要装标榜“Lua Debugger”的第三方 Sublime 插件——它们要么已停止维护，要么实际调用的是外部 GDB/LuaJIT 的 CLI 工具，配置复杂度远超收益
