Notepad++ v7.9+插件必须置于同名子目录中,如NppFTP.dll需放plugins\NppFTP\下,不能放根目录;路径须严格匹配大小写、无空格/中文,且便携版与安装版插件路径完全不同。

插件必须放在同名子目录里,不能直接丢进 plugins 根目录
Notepad++ v7.9+(包括当前最新版 8.9.7)完全跳过对 plugins\ 根目录下 DLL 文件的扫描。它只检查每个子目录,且要求子目录名与主 DLL 文件名(不含 .dll)**逐字符一致**,包括大小写。
常见错误现象:插件菜单空白、Alt+P 看不到条目、重启后毫无反应——其实 DLL 根本没被读取。
-
NppFTP.dll必须放在plugins\NppFTP\NppFTP.dll,不是plugins\NppFTP.dll -
MarkdownViewerPlusPlus.dll必须放在plugins\MarkdownViewerPlusPlus\MarkdownViewerPlusPlus.dll,不是plugins\markdownviewerplusplus\或plugins\MarkdownViewer++\ - 路径含中文、空格或括号(如
plugins\JSON Viewer\)会导致加载器静默跳过整层目录
便携版和安装版的 plugins 路径完全不同
Notepad++ 不会自动“猜”你用的是哪种部署方式。它根据可执行文件属性决定插件目录位置,放错路径等于没装。
验证方式:右键 notepad++.exe → 属性 → 详细信息 → 查看「原始文件名」是否含 portable 字样。
- 便携版(含 portable):插件目录必须是
notepad++.exe同级的plugins\,例如D:\npp\plugins\ - 安装版(不含 portable):默认为
C:\Program Files\Notepad++\plugins\(64 位)或C:\Program Files (x86)\Notepad++\plugins\(32 位) - 误把便携版插件扔进
C:\Program Files\Notepad++\plugins\,Notepad++ 会彻底忽略
子目录名与 DLL 名不一致?Notepad++ 就当它不存在
Windows 文件系统虽不区分大小写,但 Notepad++ 插件加载器内部做字符串比对时是严格匹配的。哪怕只差一个字母、一个大小写、一个加号,都会导致加载失败。
错误示例:plugins\HexEditor\hexeditor.dll、plugins\JSMinNPP\jsminnpp.dll、plugins\ComparePlus\ComparePlus_v0.5.dll —— 全部无效。
- 正确做法:用 PowerShell 快速检查(以安装版为例):
Get-ChildItem "$env:ProgramFiles\Notepad++\plugins\*" -Directory | ForEach-Object { $dll = Get-ChildItem $_.FullName -Filter *.dll -ErrorAction SilentlyContinue; if($dll) { "$($_.Name): $($dll.Name)" } } - 输出中若出现
HexEdit: HexEditor.dll这类不一致项,立刻重命名目录 - 部分插件(如
HexEditor.dll)还依赖同目录下的locale\子文件夹,缺失会导致启动时报Failed to load plugin
插件目录权限或符号链接导致加载静默失败
尤其在 Windows 10/11 上,若 plugins 目录位于 Program Files 下且当前用户无写入权限,系统可能拦截文件创建或修改操作;符号链接(mklink)也可能被加载器跳过。
- 检查权限:右键
plugins文件夹 → 属性 → 安全 → 确认当前用户有「写入」权限 - 避免使用符号链接指向插件目录,Notepad++ 不识别
- 企业定制版或某些绿色版可能禁用插件目录自动发现逻辑,需检查
notepad++.ini中[Settings]段是否有pluginsDir=自定义路径 - 安装后务必关闭所有
notepad++.exe进程(包括后台残留),否则旧内存映射仍会加载失败插件
真正卡住人的地方,往往不是插件本身坏了,而是目录结构里某一处大小写、空格、路径层级或权限刚好踩中 Notepad++ 的硬性校验规则——它不报错,也不提示,就只是安静地跳过。











