notepad++ 不能直接运行 lua 脚本,需依赖系统已安装的 lua.exe;通过 f5 输入 lua "$(full_current_path)" 可调用外部解释器执行,但须注意路径、编码及中文乱码问题。

Notepad++ 本身不能直接运行 Lua 脚本
Notepad++ 是个文本编辑器,不是 Lua 解释器。你看到的“运行 Lua 脚本”功能,其实是通过外部命令调用系统已安装的 lua.exe 来执行当前文件——前提是你的电脑上已正确安装 Lua,并且 lua.exe 在系统 PATH 中,或者你手动指定了完整路径。
常见错误现象:Cannot find lua.exe、The system cannot find the file specified、点击“运行”后窗口一闪而过没输出。
- 确认是否已安装 Lua:在命令行运行
lua -v,应返回类似Lua 5.4.6 - Windows 用户推荐使用 LuaBinaries 或 Lua for Windows(后者自带环境变量配置)
- 不要用仅含
lua54.dll的精简包——它没有可执行的lua.exe
配置 Notepad++ 的“运行”命令来执行 Lua 文件
需要把 Notepad++ 的「运行 → 运行…」菜单绑定到 lua 命令,并让其传入当前文件的绝对路径。这是最轻量、无需插件的方式。
操作步骤:
- 按
F5打开「运行」对话框 - 输入:
lua "$(FULL_CURRENT_PATH)"(注意引号必须是英文双引号,$(FULL_CURRENT_PATH)是 Notepad++ 内置变量) - 点「保存…」,起个名字如
Run Lua,快捷键可设为Ctrl+Shift+L - 以后编辑完
test.lua,按快捷键即可在终端窗口中运行
⚠️ 如果脚本含中文路径或输出中文,Windows 控制台默认编码可能是 GBK,而 Lua 默认按 UTF-8 读取字符串——可能导致乱码。临时解决:在脚本开头加 os.execute("chcp 65001 >nul") 切换控制台为 UTF-8。
处理 Lua 字符串时,别在 Notepad++ 里依赖“实时预览”
Notepad++ 没有内建 Lua 解释引擎,所有字符串处理逻辑(比如 string.gsub、string.match、正则替换)都必须写成完整可执行脚本,再调用外部 lua.exe 运行。不存在“选中一段文本 → 右键 → Lua 处理”的交互式能力(除非你装了第三方插件,但稳定性和维护性差)。
更务实的做法:
- 把常用字符串操作封装成小脚本,例如
trim.lua接收剪贴板内容或命令行参数 - 用
io.read()或arg[1]读入待处理文本,避免硬编码 - 调试时加
print,别依赖 Notepad++ 窗口——输出都在弹出的 cmd 窗口中 - 如果频繁做查找替换,优先用 Notepad++ 自带的「查找 → 替换」(支持 PCRE 正则),比写 Lua 更快
想让 Lua 脚本处理当前编辑器中的选中文本?得靠 NppExec 插件
原生 Notepad++ 不支持将选区传给外部程序,但 NppExec 插件可以。它允许你写一小段指令,把当前选区写入临时文件,再调用 lua 执行并读回结果。
简要流程:
- 通过「插件 → Plugins Admin」安装
NppExec - 「插件 → NppExec → Execute」,输入:
SET TMPFILE = $(SYS.TEMP)\nppexec_lua_tmp.lua NPP_SAVE SEL_SAVETO $(TMPFILE) CMD /C lua "$(PLUGINS_CONFIG_DIR)\process_selection.lua" "$(TMPFILE)" DEL $(TMPFILE)
其中 process_selection.lua 需自行编写:读取传入的临时文件、处理字符串、print 结果。注意该方式无法自动替换选区,只能靠人工复制输出结果。
这已经超出“运行脚本”的范畴,进入自动化集成阶段——多数人卡在路径权限、编码、临时文件残留上,不如直接用 VS Code + Lua 插件或专用文本处理工具来得可靠。











