便携版插件必须手动创建在与notepad++.exe同级的plugins文件夹内,v7.9+要求每个插件置于同名子目录(如nppftp.dll需放入plugins\nppftp\),子目录名须与dll主文件名逐字符一致(区分大小写),且依赖文件须一并放入该子目录。

便携版插件必须放在和 notepad++.exe 同级的 plugins 目录下
Notepad++ 便携版不会自动生成 plugins 文件夹,你得手动创建。它不认 %APPDATA%\Notepad++\plugins,也不认 C:\Program Files\Notepad++\plugins——哪怕你把 DLL 复制过去了,它启动时连扫描都不会扫。验证是不是便携版:右键 notepad++.exe → 属性 → 详细信息 → 看「原始文件名」是否含 portable 字样。含,就是便携版;不含,就是安装版。
常见错误包括:
- 把便携版解压到
D:\Tools\Notepad++Portable\,却把插件扔进C:\Program Files\Notepad++\plugins\ - 在解压目录下建了
plugins,但直接把NppFTP.dll放进plugins\根目录(v7.9+ 开始完全无效) - 子目录名写成
nppftp或NppFTP_x64,大小写或后缀不一致就加载失败
v7.9+ 版本必须为每个插件建同名子目录
从 v7.9 起,Notepad++ 只扫描 plugins 下的**子目录**,且要求子目录名与主 DLL 文件名(不含 .dll)逐字符一致。比如 JSONViewer.dll 必须放在 plugins\JSONViewer\JSONViewer.dll,而不是 plugins\jsonviewer\ 或 plugins\JSONViewer.dll。
这个规则对大小写敏感,也对文件名中的点、下划线、版本号敏感。例如:
-
XMLTools.dll→ 必须放plugins\XMLTools\XMLTools.dll -
ComparePlugin.dll→ 必须放plugins\ComparePlugin\ComparePlugin.dll -
NppFTP.dll和NppFTP_x64.dll是两个不同插件,需分别建plugins\NppFTP\和plugins\NppFTP_x64\
依赖文件(如 libcurl.dll、msvcp140.dll)也必须一并放进该子目录,不能丢在根目录或系统路径里。
安装版插件路径优先走 %APPDATA%\Notepad++\plugins
v8.0+ 安装版默认优先读取 %APPDATA%\Notepad++\plugins(注意不是 %APPDATA%\Notepad++ 根目录),这个路径不需要管理员权限,且绕开了 Windows UAC 对 Program Files 的写入限制。
操作步骤很简单:
- 手动创建
%APPDATA%\Notepad++\plugins - 为每个插件建子目录,如
%APPDATA%\Notepad++\plugins\Explorer\ - 把
Explorer.dll放进去,重启 Notepad++ 即可出现在 Plugins 菜单中
如果你曾用管理员身份装过旧版,并把插件放在 C:\Program Files\Notepad++\plugins,建议清空那里,改用 %APPDATA% 路径——否则可能因权限静默失败,或者新旧路径冲突导致部分插件加载异常。
企业定制版或绿色版可能禁用自动插件发现
有些单位分发的 Notepad++ 是定制打包版,会修改 notepad++.ini 文件,在 [Settings] 段强制指定 pluginsDir=。如果插件始终不加载,打开 notepad++.ini 检查这一行是否存在。若存在,要么删掉它让 Notepad++ 自动识别,要么确保你放插件的路径和它指定的一致。
另一个容易被忽略的点是:某些插件(如 PythonScript)本身有独立配置目录,它不依赖 Notepad++ 的插件扫描机制,而是通过 plugins\Config\PythonScript\ 子路径加载脚本——这类插件即使主 DLL 加载成功,脚本目录位置不对也会报“找不到脚本”错误。











