先确认lua.exe能否正常调用:在CMD中执行lua -v,必须显示类似Lua 5.4.6的版本信息;若提示“not recognized”,说明未安装或PATH未配置,需下载预编译版并添加路径,且必须彻底重启Notepad++。

lua 命令行报错但 Notepad++ 无输出?先确认 lua.exe 能否正常调用
Notepad++ 本身不解析 Lua,所有错误都来自你本地的 lua.exe。如果按下 F5 后黑窗一闪就消失、或根本没反应,大概率是 lua.exe 根本没被系统识别。
打开 CMD 或 PowerShell,执行:lua -v
必须看到类似 Lua 5.4.6 的输出才算通过。若提示 'lua' is not recognized,说明:
- 没装 Lua:去
luabinaries.org下载预编译版(如lua-5.4.6_Win64_bin.zip),解压后把含lua.exe的目录(如C:\lua\)加进系统 PATH - PATH 改了但 Notepad++ 没重启:必须彻底关闭再重开,仅新建窗口无效
- 误用了带版本号的文件名(如
lua54.exe):F5 命令里写lua就行,靠 PATH 解耦更稳
错误信息一闪而过?用 cmd /k + PAUSE 保留控制台
F5 运行命令若写成 lua "$(FULL_CURRENT_PATH)",出错后黑窗会立即关闭,根本看不到报错内容。
正确写法是:cmd /k lua "$(FULL_CURRENT_PATH)" & PAUSE
其中:
-
cmd /k表示执行完命令后保持窗口打开 -
& PAUSE是额外保险,防止某些异常路径下窗口仍闪退 -
"$(FULL_CURRENT_PATH)"必须加英文双引号——路径含空格(如C:\my project\test.lua)时,不加引号会被 cmd 当成两个参数,lua.exe只收到前半段
错误行点不了、跳不过去?换 NppExec 并开启 Follow console output
原生 Run → Run 不解析错误格式,比如 test.lua:23: attempt to index a nil value 这种标准 Lua 错误,它只当普通文本输出,无法点击跳转。
NppExec 可以真正捕获并解析这类错误:
- 插件 → 插件管理 → 安装
NppExec(确保 v1.0+,旧版不支持 UTF-8 输出) - 插件 → NppExec → Execute,输入:
cd "$(CURRENT_DIRECTORY)" && lua "$(FILE_NAME)"$1$2$3 - Save 为
Run Lua,再进 Advanced Options → Add to Menu - 关键一步:勾选
Follow console output with caret—— 这样点击输出里的test.lua:23就能自动跳到第 23 行
中文乱码导致报错 near '▒'?检查 BOM 和编码一致性
报错 lua: unexpected symbol near '▒' 几乎全是 UTF-8 BOM 惹的祸:Notepad++ 新建文件默认可能带 BOM,而 Lua 5.3+ 解析器会把 \xEF\xBB\xBF 当非法字符。
立刻修复步骤:
- 打开出错的
.lua文件,菜单栏点编码 → UTF-8(注意不是UTF-8-BOM) - 按
Ctrl+S保存,右下角状态栏应显示纯UTF-8(无 BOM 标识) - 新建文件时,提前设好:设置 → 首选项 → 新建文档/默认目录 → 新建文档编码选
UTF-8,且取消勾选以UTF-8-BOM格式编码 - 如果输出中文仍乱码,NppExec 脚本开头加:
chcp 65001 >nul &&
真正难搞的是 Windows 控制台、Notepad++、Lua 文件三者编码错位——BOM、GBK 残留、区域设置不统一,任何一个环节没对齐,都会让错误信息变成一堆方块或直接崩溃。


















