Notepad++插件DLL必须严格按plugins\PlugName\PlugName.dll路径放置,大小写全匹配;位数须与Notepad++完全一致(x64/x86);安装/便携版路径不同;必须彻底退出进程后重启。

插件 DLL 放对位置了吗
Notepad++ 不会扫描 plugins\ 根目录下的 DLL,也不会识别错位的子目录结构。它只认一种路径模式:plugins\<i>PluginName</i>\<i>PluginName</i>.dll,且大小写必须完全一致。
- 比如
JSONViewer.dll必须放在plugins\JSONViewer\JSONViewer.dll,不能是plugins\jsonviewer\JSONViewer.dll或plugins\JSONViewer.dll - 旧版插件(如
Compare.dll、NppFTP.dll)在 v7.9 之前可放根目录,但 v8.0+ 已统一要求子目录结构,混用会静默失效 - 便携版和安装版的
plugins路径不同:便携版是与notepad++.exe同级;安装版默认在C:\Program Files\Notepad++\plugins\,别放错盘符或路径层级
Notepad++ 和插件位数是否严格匹配
64 位 Notepad++ 加载 32 位 DLL,或反过来,不会报错,而是直接跳过——菜单里没条目、插件窗口打不开、甚至启动黑屏。这是最隐蔽也最常被忽略的失败原因。
- 查 Notepad++ 位数:菜单「帮助 → 关于 Notepad++」右下角明确标有
64-bit或32-bit - 查插件位数:用
Dependencies.exe(v1.14+)打开 DLL,看「Machine Type」字段是AMD64(x64)还是Intel 386(x86) - GitHub Release 页面下载时,认准文件名含
-x64或-x86后缀;无后缀的包大概率是旧版、不兼容当前 Notepad++
进程是否彻底退出再重启
Notepad++ 启动时会缓存插件列表,如果后台还有残留进程,新放进去的 DLL 永远不会被扫描到——哪怕你改了十次路径,它都当没这回事。
- 任务管理器 → 「详细信息」页,确认所有
notepad++.exe和notepad++64.exe进程已结束 - 尤其注意隐藏图标区的小图标,右键退出可能只是最小化,不是关闭
- 重启前可临时重命名
plugins文件夹为plugins_old,再新建空plugins并放入目标 DLL,排除旧配置干扰
NppFTP 等插件加载后功能异常
能出现在菜单里,但点开就卡在 “Connecting…” 或弹出 Authentication failed,往往不是插件没装好,而是运行时依赖缺失或配置错位。
-
NppFTPv0.30+ 强制依赖.NET Framework 4.7.2+;若系统只有 4.0,它会静默加载失败——降级到 v0.29 或升级框架 - 协议选错:阿里云/腾讯云 ECS 默认关 SFTP 子系统,应选
FTP或FTP over TLS,而非默认的SFTP - 根目录填了
/:很多 Linux 服务器禁止列出根目录,改成.(家目录)或具体路径如/var/www/html


















