Notepad++ 本身不能直接运行 Lua 模块文件，因其是纯文本编辑器，无内置解释器；必须通过系统已安装的 lua.exe（如 lua5.4.exe）调用，且模块文件（如 mylib.lua）不含顶层执行逻辑，需由其他脚本（如 main.lua）通过 require 加载才能生效。
Notepad++ 本身不能直接运行 Lua 模块文件
Notepad++ 是纯文本编辑器，不带解释器或运行时环境。所谓“运行 Lua 模块”，本质是调用系统已安装的 lua 可执行程序（如 lua5.4.exe 或 luajit.exe）来执行你的文件。模块文件（比如 mylib.lua）通常不含 if not ... then ... end 之外的顶层执行逻辑，直接运行会“没反应”或报错 attempt to call a nil value (global 'main') —— 因为它不是脚本，而是被其他文件 require 的。
必须先确认系统已安装 Lua 并能命令行调用
打开 CMD 或 PowerShell，输入：
lua -v
如果提示“不是内部或外部命令”，说明未安装或未加到 PATH。此时 Notepad++ 无法调用。解决步骤：
- 下载官方二进制（推荐 luabinaries）或使用
scoop install lua（Windows） - 把
lua.exe所在目录（如C:Program FilesLua.4）加入系统环境变量PATH - 重启 Notepad++（否则插件看不到新 PATH）
- 验证：在 Notepad++ 中按
F5→ 输入lua -v→ 点击“运行”，应输出版本号
用 NppExec 插件运行“可执行的 Lua 脚本”，而非纯模块
模块文件（mylib.lua）本身不应被直接运行；真正该运行的是引用它的脚本（如 main.lua），内容类似：
local mylib = require("mylib")
print(mylib.hello())
在 Notepad++ 中配置 NppExec 运行它：
- 菜单栏 → 插件 → NppExec → Execute...
- 输入命令：
lua "$(FULL_CURRENT_PATH)" - 勾选 “保存当前文件”（避免改完忘了存）
- 点击“保存” → 命名为
Run Lua→ 后续可用F6快速调用
注意：require 查找路径默认不包含当前目录（Windows 下需手动加 package.path = package.path .. ';./?.lua'），否则 require("mylib") 会报 module 'mylib' not found。
调试模块时容易忽略的两个关键点
直接双击运行模块文件，或在 require 前没设好路径，是 90% 的失败原因：
-
require不加载.\mylib.lua，只认模块名（无扩展名、无路径），且默认搜索LUA_PATH中的模式，如./?.lua、C:path?.lua - 模块内如果有
print或error，但文件没被require或dofile触发，就不会输出——它只是定义，不是执行 - 想快速验证模块导出是否正确？临时在模块末尾加一段测试代码，用
if not ... then ... end包裹，例如：if not ...debugging... then print("test:", myfunc()) end
模块不是脚本，它的“运行”发生在被加载那一刻，而不是你双击它的时候。
