notepad++需本地安装lua.exe并配置path才能运行lua脚本;f5运行命令为“lua "$(full_current_path)"”,中文路径需加引号,乱码问题可通过chcp 65001临时解决。

Notepad++ 本身不能运行 Lua 脚本
Notepad++ 是纯文本编辑器,没有内置解释器,lua.exe 必须由你本地安装并手动调用。所谓“配置运行环境”,本质是让 Notepad++ 通过 Run → Run...(或快捷键 F5)调起系统已有的 lua.exe,并把当前文件路径传给它。
确认 lua.exe 是否可用且在 PATH 中
这是最常卡住的一步:Notepad++ 的 Run 命令默认使用系统环境变量,如果 lua.exe 不在 PATH 里,会直接报错 'lua' is not recognized as an internal or external command。
- 打开命令行(
cmd或PowerShell),输入lua -v—— 应返回类似Lua 5.4.6 - 如果失败,去 lua.org/download 下载 Windows 二进制版(推荐
lua-5.4.6_Win64_bin.zip),解压后把lua.exe所在目录(如C:\lua\)加进系统PATH - 改完
PATH后,**必须重启 Notepad++**(不是新建窗口,是彻底关闭再打开),否则新环境变量不生效
在 Notepad++ 中设置 F5 快捷运行
目标是按下 F5 后,自动执行类似 lua "D:\project\test.lua" 的命令。
- 菜单栏点
Run → Run...(或按F5) - 输入框中填:
lua "$(FULL_CURRENT_PATH)"—— 注意双引号包裹路径,防止含空格时报错 - 点
Save...,起个名字如Run Lua,快捷键建议设为F5(会覆盖默认“运行”功能,但更顺手) - 如果想看到控制台输出,勾选
Use output pane;不勾选则弹独立黑窗(适合调试时看os.exit()或错误堆栈)
遇到中文路径或 print 输出乱码怎么办
Windows 控制台默认 GBK 编码,而 Notepad++ 默认 UTF-8,print("你好") 直接输出会是乱码,这不是 Notepad++ 的问题,是 lua.exe 和 cmd 编码不一致导致的。
- 临时解决:在
Run命令前加chcp 65001 &&,即完整填入:chcp 65001 && lua "$(FULL_CURRENT_PATH)" - 根本解决:改系统区域设置为“Beta: 使用 Unicode UTF-8 提供全球语言支持”(需重启),但会影响其他旧程序,慎用
- 另:Lua 5.4+ 支持
io.stdout:setvbuf('no')强制刷新,对调试有帮助,但不解决编码问题
lua.exe、路径没加 PATH、没重启编辑器、中文路径漏引号、cmd 编码不匹配,任一环节断掉都会静默失败或乱码。真正要跑起来,得一个个验证这些底层依赖,而不是只配一个菜单项。







