错误源于UTF-8 BOM编码,Notepad++需改为UTF-8无BOM保存;F5运行不捕获错误,应改用NppExec并勾选“Follow console output with caret”实现点击跳转;中文路径须加英文双引号,乱码需加chcp 65001命令。

错误信息里带 near '▒' 怎么办
这不是语法问题,是文件编码惹的祸。Notepad++ 默认保存为 UTF-8 with BOM,而 Lua 解释器(尤其是 5.4 之前版本)会把 BOM 当作非法字符,报出类似 lua: test.lua:1: unexpected symbol near '▒' 的错误,且总说第一行有问题。
解决方法很简单:用 Notepad++ 打开脚本 → 菜单栏点 Encoding → UTF-8(注意不是“UTF-8-BOM”)→ 保存。再运行就过了。
这个坑不看报错细节很容易卡住,因为代码明明写对了,但解释器根本没开始解析语法,就在读取字节流阶段崩溃了。
错误行号点不跳转、输出一闪而过
默认的 F5 运行(lua "$(FULL_CURRENT_PATH)")只调 cmd 弹黑窗,stderr 不捕获,错误堆栈打完就关窗,你根本来不及看第几行错。
必须换 NppExec 插件才能真正定位:
- 安装 NppExec 后,执行命令填:
cd "$(CURRENT_DIRECTORY)" && lua "$(FILE_NAME)" - 保存为 “Run Lua”,进 Advanced Options → Add to Menu
- 务必勾选 Follow console output with caret
这样当出现 test.lua:27: attempt to index a nil value 时,点击这行就能直接跳到第 27 行——前提是错误格式是标准的 file.lua:line: message,Lua 默认就是。
中文路径导致报错或崩溃
错误现象常是 lua: cannot open test.lua: No such file or directory,但文件明明存在。原因不是文件丢了,是 Windows cmd 把含空格或中文的路径(如 C:\我的项目\test.lua)按空格/特殊字符截断,只传了 C:\我的项目\test.lua 前半段给 lua.exe。
两个硬性要求:
-
"$(FULL_CURRENT_PATH)"必须加英文双引号,不能省 - 如果用 NppExec,
lua "$(FILE_NAME)"中的$(FILE_NAME)不带路径,所以必须先cd "$(CURRENT_DIRECTORY)"切工作目录,否则相对路径 io.open("data.txt") 也会失败
别指望 lua.exe 自己处理路径编码,它只认字节流;引号是 shell 层的事,漏了就解析失败。
控制台输出中文全是乱码
print("你好") 显示成 浣犲ソ 或方块,不是脚本错了,是 cmd 默认用 GBK 编码,而 Notepad++ 用 UTF-8 编辑并保存文件,两边对不上。
临时解法:在运行命令最前面加 chcp 65001 &&,例如:chcp 65001 && lua "$(FULL_CURRENT_PATH)"
根本解法是系统级改 UTF-8 模式(设置 → 时间和语言 → 区域 → 管理 → 更改系统区域设置 → 勾选 Beta UTF-8),但会影响老旧程序,日常调试用 chcp 65001 更稳妥。
注意:io.stdout:setvbuf('no') 只强制刷新缓冲区,跟编码无关,别在这上面浪费时间。


















