lua.exe 必须添加到系统PATH而非Notepad++设置中,F5运行依赖Windows环境变量查找;需用双引号包裹"$(FULL_CURRENT_PATH)",并显式切换工作目录或使用NppExec插件。

lua.exe 必须在系统 PATH 里,不是 Notepad++ 设置路径
Notepad++ 本身不带 Lua 解释器,lua.exe 的“运行路径”根本不在编辑器里配——它靠 Windows 系统环境变量 PATH 查找。你按 F5 运行时,Notepad++ 只是调用 cmd 执行 lua 命令,背后完全依赖系统能否识别这个命令。
常见错误现象:'lua' is not recognized as an internal or external command —— 这说明 Notepad++ 根本没机会执行脚本,卡在第一步。
- 打开 CMD 或 PowerShell,直接输入
lua -v;有输出(如Lua 5.4.6)才算通过 - 若报错,去
luabinaries.org下载预编译版(如lua-5.4.6_Win64_bin.zip),解压后把含lua.exe的目录(例如C:\lua\)加进系统PATH - 改完
PATH后,必须彻底关闭 Notepad++(不是新建窗口),再重开——否则新环境变量不生效
F5 命令里的 "$(FULL_CURRENT_PATH)" 不是工作路径,只是文件路径
$(FULL_CURRENT_PATH) 是 Notepad++ 提供的宏,只负责拼出当前文件的完整路径(如 C:\my proj\test.lua),但它不会自动切换到该目录执行。Lua 脚本里用 io.open("data.txt") 会去 Notepad++ 安装目录找文件,而不是你脚本所在目录。
解决方法只有两种:
- 在 F5 命令里显式切工作目录:写成
cmd /k cd /d "$(CURRENT_DIRECTORY)" && lua "$(FILE_NAME)" & PAUSE - 改用 NppExec 插件,并勾选
Follow $(CURRENT_DIRECTORY)(插件设置里有这选项),它能真正把工作目录设对 - 别依赖相对路径:脚本里统一用
debug.getinfo(1,"S").source:sub(2)或arg[0]推导脚本所在目录
中文路径或空格导致命令截断,引号不是可选项
Windows cmd 把空格当参数分隔符。如果路径是 C:\my project\test.lua,不加引号的话,lua C:\my project\test.lua 会被拆成 lua C:\my 和 project\test.lua 两段,后者被丢弃——lua.exe 实际收到的是一个不存在的路径,静默失败或报错 cannot open C:\my: No such file or directory。
-
"$(FULL_CURRENT_PATH)"必须用英文双引号包裹,且不能漏掉 - 不要写成
lua54.exe或lua-5.4.exe—— 这类带版本号的文件名会让 PATH 解耦失效,升级 Lua 后立刻崩 - 如果路径含中文,还要额外加
chcp 65001 &&前缀,否则控制台输出乱码(但脚本执行本身不受影响)
NppExec 比 F5 更可靠,尤其要传参或跳错误行
F5 的 Run 功能本质是 shell 命令转发,不捕获 stderr、不支持参数占位、点不了报错行。而 NppExec 插件能真正把 Lua 当成开发环境来用。
- 安装后,进
Plugins → NppExec → Execute,输入:cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)" $1 $2 $3
其中$1、$2是运行时弹窗填的参数(如--verbose config.json) - 保存为
Run Lua,再进Advanced Options → Add to Menu,勾选Follow console output with caret - 这样当 Lua 报错
test.lua:23: attempt to index a nil value,直接点击就能跳转到第 23 行
最易被忽略的一点:NppExec 默认输出编码是 ANSI,若 Lua 脚本用了 io.write("中文"),得在插件设置里启用 UTF-8 输出支持,否则照样乱码——这个开关藏在 NppExec → Console Output → UTF-8 mode 里。











