Notepad++ 默认工作目录为安装路径而非当前文件目录,需用 NppExec 执行“cd "$(CURRENT_DIRECTORY)"”切换目录后再运行 Lua 脚本,F5 无法设置工作目录,原生运行不支持多命令或路径切换。

Notepad++ 默认工作目录不是当前文件所在目录
直接按 F5 运行 lua "$(FULL_CURRENT_PATH)" 时,Lua 脚本内部调用 os.getcwd() 或打开相对路径文件(如 require "lib.utils"、io.open("config.json")),往往读不到预期文件——因为 Notepad++ 的默认工作目录是它自己的安装路径(比如 C:\Program Files\Notepad++),不是你编辑的 test.lua 所在目录。
NppExec 必须显式切换目录才能正确加载相对路径
仅靠 $(FULL_CURRENT_PATH) 传路径给 lua.exe 不解决工作目录问题;必须先用 cd 命令切到脚本所在目录。NppExec 是唯一可靠支持这一步的方案:
- 插件 → NppExec → Execute…,输入以下两行(注意换行):
cd "$(CURRENT_DIRECTORY)" lua "$(FILE_NAME)"
-
$(CURRENT_DIRECTORY)是 Notepad++ 宏变量,返回不含文件名的完整路径(如D:\proj\src) -
$(FILE_NAME)只含文件名(如main.lua),和cd配合才真正模拟「在脚本目录下执行」 - 不要写
cd $(FULL_CURRENT_PATH)—— 这会尝试切换到带文件名的路径,必然失败
Run → Run(F5)无法设置工作目录
原生的「运行 → 运行…」对话框不支持多命令或目录切换,cmd /k cd "$(CURRENT_DIRECTORY)" && lua "$(FILE_NAME)" 这类写法在 F5 中会被截断或解析错误,实际只执行了前半段。所以:
- 如果坚持用 F5,只能把所有依赖文件(模块、配置、数据)全放到 Notepad++ 安装目录下——不现实也不安全
- 若脚本硬编码了相对路径(如
../assets/data.csv),cd切到$(CURRENT_DIRECTORY)后依然可能错位,得按真实层级补足cd ..\assets等手动调整 - 旧版 NppExec(v0.x)默认不跟随目录,需进
Advanced Options → Follow $(CURRENT_DIRECTORY)勾选,新版(v1.0+)默认已启用
验证工作目录是否生效的最简方法
在 Lua 脚本开头加一行诊断输出,比空猜更准:
print("CWD:", os.getenv("CD") or os.execute("cd"))
或更通用的:
local handle = io.popen("cd")
print("CWD:", handle:read("*a"):gsub("%c+", ""))
运行后看控制台输出的实际路径是否与你期望的 $(CURRENT_DIRECTORY) 一致。只要输出不对,就说明 cd 没执行成功,或变量没被正确展开——这时候回看 NppExec 指令里引号是否漏了、反斜杠是否写成正斜杠、路径是否存在。


















