根本原因是Windows下Sublime用ANSI（如GBK）解析中文路径，而lua.exe（5.4+）只接受UTF-8路径字符串，导致路径传入即乱码，io.open()找不到文件；需改用纯英文路径或绕过路径传递环节。
为什么 Lua 脚本在 Sublime 里报 cannot open xxx: No such file or directory
根本不是文件真丢了，而是路径编码或解析错位。Windows 下 Sublime 默认用 ANSI（如 GBK）读取当前文件路径，但 lua.exe（尤其 5.4+）只接受 UTF-8 编码的路径字符串——中间一转，中文路径就变成乱码，io.open() 或 dofile() 自然找不到目标。
常见表现：
-
cannot open config.lua: No such file or directory，但文件明明就在同目录 - 脚本里用
io.read()卡住不动，构建面板光标一直闪烁 - 相对路径（如
"./data/save.dat"）在终端能跑，Sublime 里却失败
实操建议：
- 把
.lua文件和所有依赖资源全挪到纯英文路径下（例如C:/dev/game/），这是最稳、最快验证是否为路径问题的方法 - 避免在脚本里拼接中文路径；若必须处理用户目录，改用
os.getenv("USERPROFILE")+ 硬编码子路径，绕过 Sublime 的路径传递环节 - 不要依赖 Sublime 构建面板做交互式输入——它不提供真实 stdin 终端能力，
io.read()会挂起
如何让错误点击直接跳转到正确行号
点击构建输出里的报错行没反应，或跳到错的行，大概率是 file_regex 没匹配上实际错误格式。Lua 和 LuaJIT 的报错格式不统一，正则写错就白搭。
标准 Lua（如 lua-5.4.x）错误形如：test.lua:5: attempt to call a nil value
而 LuaJIT 错误常带列号：test.lua:5:12: attempt to call a nil value
实操建议：
- 先在终端手动运行
lua test.lua或luajit test.lua，看真实报错长什么样，再反推正则 - 用 Lua 时，
file_regex设为"^(.*?):([0-9]+):?([0-9]*):? (.*)$"（支持无列号和可选列号） - 用 LuaJIT 时，强制要求列号存在：
"^(.*?):([0-9]+):([0-9]+): (.*)$" - 注意：正则里
.*?必须用非贪婪匹配，否则可能吞掉冒号前的路径部分
Ctrl+B 没反应？先查构建系统有没有被加载
不是插件没装，也不是 JSON 写得不够“全”，而是 Sublime 根本没把这个 Lua.sublime-build 绑定给当前文件——最常见原因是 selector 字段和当前文件的语言 scope 不一致。
比如你装了 Lua Enhanced 插件，它注册的 scope 是 source.lua.enhanced，但构建文件里写的还是 "selector": "source.lua"，那 Sublime 就当它不存在。
实操建议：
- 打开任意
.lua文件，按Ctrl+Shift+P→ 输入Set Syntax: Show Scope，看状态栏或控制台输出的真实 scope 名 - 如果显示
source.lua.enhanced，构建文件里就必须写"selector": "source.lua.enhanced" - 保存后务必彻底退出 Sublime（任务管理器杀进程 / Activity Monitor 强退），再重启——它只在启动时扫描
Packages/User/下的构建文件 - 检查文件是否真保存为
Lua.sublime-build（后缀不能是.txt或漏掉.sublime-build）
调试时看不到 print() 输出？别信构建面板的“实时性”
Sublime 构建面板不是终端，它对 stdout 的缓冲行为和真实 shell 不同。尤其当脚本里有大量 print() 或用了 io.write()，输出可能延迟、截断，甚至卡在某一行不动。
更麻烦的是：某些 Lua 库（如 lfs、socket）在构建环境下因缺少环境变量或权限，会静默失败，不抛异常也不输出。
实操建议：
- 在关键位置加
print(debug.traceback())，强制触发堆栈输出，比单纯print("here")更可靠 - 临时把脚本末尾加上
os.exit(0)，防止因后台线程或协程导致构建面板假死 - 真正要确认 I/O 行为，还是得切到终端执行：
cd /path/to/dir && lua script.lua，和 Sublime 结果对比 - 如果用了
require加载本地模块，确保模块路径在package.path里——Sublime 不自动设置工作目录为文件所在路径，除非你显式写了"working_dir": "$file_path"
路径和编码问题最容易被当成“Lua 脚本 bug”去 debug，其实它们都发生在 Sublime 把路径传给 lua.exe 的那一瞬间——连解释器都没进，谈不上语法或逻辑错误。
