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 层改不了父进程编码。
