notepad++ 本身不支持 lua 调试，仅能通过错误捕获、行号跳转和输出观察逼近调试效果；f5 运行无法定位错误行，因错误信息不可点击且无自动跳转；nppexec 是唯一支持解析错误格式并点击跳转的方案，前提必须确保 lua -v 在 cmd 中可执行。
Notepad++ 本身不支持调试 Lua 脚本——它没有断点、变量监视、单步执行能力。所谓“调试运行中”的脚本，实际只能靠错误捕获 + 行号跳转 + 输出观察来逼近调试效果。
为什么直接按 F5 运行无法定位错误行
Notepad++ 原生 Run 功能（F5）只是调用 cmd 执行一条命令，输出全丢进黑窗或输出面板，但：
• 错误信息如 test.lua:23: attempt to index a nil value 不可点击
• 没有自动跳转到第 23 行的功能
• stdout/stderr 混在一起，stderr（关键报错）容易被忽略
• 若脚本中途 os.exit() 或崩溃，黑窗直接关闭，来不及看错误
NppExec 是唯一能接近“调试流”的方案
它不是调试器，但能把你从“看黑窗→记行号→切回编辑器→手动翻页”中解放出来。关键在于它支持解析标准错误格式并绑定跳转：
- 插件 → 插件管理 → 安装
NppExec（v1.0+，确保支持 UTF-8 输出） - 插件 → NppExec → Execute，输入以下两行：
cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)" $1 $2 $3
• cd "$(CURRENT_DIRECTORY)" 确保 io.open("config.json") 这类相对路径能读到同目录文件
• $1 $2 $3 是运行时弹窗填入的参数占位符，比如填 --verbose data.csv
• 保存为 Run Lua，再进 Advanced Options → Add to Menu，并务必勾选 Follow console output with caret
这样当 Lua 报出 test.lua:47: bad argument #1 to 'pairs' (table expected, got nil)，点击这行就能直接跳转到第 47 行。
中文路径和乱码会直接破坏调试链路
这不是 Lua 的锅，是 Windows 控制台和 Notepad++ 编码错位导致的静默失败：
- 路径含中文且没加引号 → cmd 把
C:\我的脚本\main.lua解析成两个参数，lua只收到C:\我的脚本\main.lua前半段，报错cannot open C:\我的: No such file or directory - Notepad++ 编码设为 ANSI（默认），而脚本里写了中文字符串 → Lua 解释器读到非法字节，报
unexpected symbol near '▒' - cmd 默认代码页是 936（GBK），但 Lua 输出 UTF-8 中文 → 显示为乱码，你根本看不出报错内容是什么
临时解法：在 NppExec 命令最前面加 chcp 65001 &&，变成：
chcp 65001 && cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)" $1 $2 $3
更稳的做法：把脚本和项目路径全换成英文，Notepad++ 编码统一设为 UTF-8（无 BOM），并在脚本开头加 io.stdout:setvbuf('no') 强制实时刷输出。
真正卡住 90% 用户的其实是第一步
所有后续配置都依赖一个前提：lua -v 能在任意 cmd 窗口中成功返回版本号。如果这一步不通，NppExec 也好、F5 也好，全都会静默失败或报“找不到命令”。常见断点：
- 下载的是 zip 包但没解压，PATH 加的是压缩包路径
- PATH 加了
C:\lua\，但里面实际是C:\lua\lua54\lua.exe，少了一级目录 - 改完 PATH 后只新建 Notepad++ 窗口，没彻底关闭重开
- 用了 MinGW 编译版 lua.exe，缺少
socket、lfs等常用库，一运行就module 'socket.core' not found
别跳过验证。打开 cmd，敲 lua -v，看到 Lua 5.4.6 再动 Notepad++ 设置——这是唯一不可绕过的起点。
