notepad++插件管理器打不开是因旧版pluginadmin.dll被github raw接口拉黑。v8.5.4之前版本使用tls 1.0/1.1且无user-agent,遭403拦截;需升级至≥v8.6.5官方版并启用tls 1.2、放行防火墙、确保64位环境。

Notepad++ 插件管理器打不开、列表为空、点“Show Plugins”没反应——不是你网络差,也不是插件没了,而是你正用着一个被 GitHub raw 接口拉入黑名单的旧版 PluginAdmin.dll。
为什么 Plugin Admin 突然不显示插件列表了?
从 2026 年初开始,GitHub 强制要求所有访问 raw.githubusercontent.com 的客户端必须使用 TLS 1.2+ 且携带合法 User-Agent。旧版 PluginAdmin.dll(尤其是 v8.5.4 之前内置的版本)仍用 IE 内核发起请求,既不带 UA,又默认只启用了 TLS 1.0/1.1,结果被 GitHub 直接 403 拦截,返回空响应。Notepad++ 不报错,也不重试,就静静显示 “No new plugins available”。
常见现象包括:
- 菜单里有
Plugins → Plugin Admin,但点开后空白或仅显示 “Loading…” 后卡住 - 手动运行
nslookup raw.githubusercontent.com能通,curl -I https://raw.githubusercontent.com返回 403 - 企业网/校园网下切热点能用,说明不是 DNS 或防火墙问题,而是服务端拒绝
如何确认并替换被拉黑的 PluginAdmin.dll?
别猜,直接查文件版本和来源。Notepad++ 不会告诉你它加载的是哪个 DLL,但你可以手动定位:
- 打开
%AppData%\Notepad++\plugins\和C:\Program Files\Notepad++\plugins\(按你安装方式选其一),找名为PluginAdmin.dll的文件 - 右键 → 属性 → “详细信息” 标签页,看“产品版本”:低于
8.6.0.0的基本已失效;8.5.4.0是最后一个广泛可用的稳定版,但部分部署已开始受限 - 如果文件时间戳是 2025 年底或更早,大概率就是黑名单成员
替换方法只有一条路:重装官方最新版 Notepad++(≥v8.6.5),安装时务必勾选 “Plugin Admin”(官网安装包默认已勾选,但有人会手动取消)。不要试图从网上单独下载 PluginAdmin.dll 替换——它和 Notepad++ 主程序有强签名绑定,错配会导致插件菜单彻底消失。
升级后仍列表为空?检查这三处硬性依赖
新版 PluginAdmin.dll 对运行环境更严格,光换 DLL 不够:
-
notepad++.exe必须是 64-bit(v7.9+ 官方只发 64 位),且 Windows 系统需启用 TLS 1.2:打开“Internet 选项 → 高级 → 安全”,确保TLS 1.2已勾选(TLS 1.0/1.1可关可留,但不能全关) - Windows 防火墙必须放行
notepad++.exe的出站连接,且“专用”和“公用”网络都要打勾——缺一不可 - 插件列表地址已从 XML 切换为 JSON 接口:
https://raw.githubusercontent.com/notepad-plus-plus/nppPluginList/master/src/plugindlgs.json。若你本地 hosts 或 DNS 拦截了该域名(哪怕只拦截了raw.githubusercontent.com),Plugin Admin 就会静默失败
实在无法联网?离线安装插件的唯一可靠路径
别信“把插件 ZIP 解压到 plugins 目录就行”的说法。Notepad++ 8.0+ 对插件目录结构有强制约定:
- 每个插件必须放在
plugins\<pluginname>\<pluginname>.dll</pluginname></pluginname>,例如NppFTP.dll必须在plugins\NppFTP\NppFTP.dll,不能放在plugins\根目录 - 子目录名必须与 DLL 文件主名完全一致(大小写敏感),
nppftp.dll放进plugins\NppFTP\也不会被识别 - 64 位 Notepad++ 只加载 64 位 DLL:下载时认准 Release 页面带
-x64.zip后缀的包,解压后检查 DLL 是否真为 64 位(用file命令或 CFF Explorer 查 PE 头)
最常被忽略的点:插件启动依赖 Notepad++ 的 API 版本。比如 v8.6.5 要求 NppFTP v0.42+,用 v0.41 会触发 PluginsManager:runPluginCommand Exception 并静默跳过——连错误日志都不写。











