notepad++运行lua脚本必须依赖本地lua.exe,需先确认其在path中可用(cmd输入lua -v有版本输出),再安装nppexec插件并配置cd "$(current_directory)"和lua "$(file_name)" $1 $2 $3脚本,启用follow console output with caret实现错误行跳转,中文路径问题通过chcp 65001 >nul及转utf-8-bom解决。

确认lua.exe已在系统PATH中可用
Notepad++ 本身不带 Lua 解释器,NppExec 插件调用的仍是本地 lua.exe。如果 lua -v 在 CMD 或 PowerShell 中报错 'lua' is not recognized,后续所有插件配置都会静默失败。
必须完成三件事:
- 从
luabinaries.org下载预编译版(如lua-5.4.6_Win64_bin.zip),解压后记下lua.exe所在目录(例如C:\lua\) - 将该目录添加进系统环境变量
PATH - 彻底关闭 Notepad++(不是新建窗口),再重新打开——否则新
PATH不生效
NppExec 插件安装与基础执行脚本
NppExec 是唯一能稳定支持参数传递、错误行跳转和 UTF-8 输出的方案,比 F5 内置 Run 强得多。
操作步骤:
- 菜单栏 → 插件 → 插件管理 → 搜索 NppExec → 勾选安装(v1.0+ 版本才默认支持 UTF-8 输出)
- 插件 → NppExec → Execute…,粘贴以下两行:
cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)" $1 $2 $3
说明:
-
cd "$(CURRENT_DIRECTORY)"确保脚本内用io.open("config.json")能读到同目录文件 -
"$(FILE_NAME)"是当前文件名(不含路径),配合cd使用才安全;别用"$(FULL_CURRENT_PATH)",它含空格或中文时容易崩 -
$1 $2 $3是运行时弹窗填入的参数占位符,比如输入--debug data.lua,就会等价于命令行执行lua test.lua --debug data.lua
保存为菜单项并启用错误跳转
只执行一次没用,得固化成可复用的操作。
在 NppExec Execute 对话框中:
- 点 Save…,命名为
Run Lua - 再点 Advanced Options → Add to Menu,让它出现在插件菜单里
- 勾选 Follow console output with caret —— 这是关键:当 Lua 报错如
test.lua:23: attempt to index a nil value,点击这行输出,光标会自动跳到第 23 行
注意:Follow console output with caret 依赖 Lua 默认错误格式(含 :行号:),不要用 pcall 吞掉原始错误或自定义 print 包裹,否则跳转失效。
中文路径/乱码问题怎么破
即使 NppExec 正常工作,中文路径或 print("你好") 仍可能显示方块或问号——这不是插件问题,而是 Windows 控制台编码和 Notepad++ 编码不一致。
两个最低成本解法:
- 在 NppExec 脚本第一行加:
chcp 65001 >nul(强制 CMD 切 UTF-8),完整脚本变成:
chcp 65001 >nul cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)" $1 $2 $3
- Notepad++ 菜单 → 编码 → 转为 UTF-8-BOM(Lua 解释器对 BOM 更友好,尤其含中文字符串时)
不推荐改系统区域设置,影响面太大;也别依赖 os.execute("chcp 65001") 放 Lua 脚本里,CMD 层级已固定,Lua 层改不了父进程编码。











