根本原因是网络无法直连github raw服务器且插件管理器不支持代理或镜像。旧版plugin manager需手动配置http代理;新版plugins admin须替换pluginlist.xml为gitee镜像源。

Notepad++插件管理器显示“无法连接到插件列表”
根本原因通常是插件管理器(Plugin Manager)默认走系统代理或直连,但国内网络环境下既没配代理又无法直连官方服务器 https://raw.githubusercontent.com。它不读取浏览器代理,也不自动继承系统全局代理设置,更不会提示你缺代理配置。
实操上最直接的解法是手动指定代理地址和端口——但注意:Notepad++ 7.9+ 版本已弃用旧版 Plugin Manager,改用 Plugins Admin(基于 GitHub API),而它压根不支持代理配置。所以第一步得确认你用的是哪个插件管理器:
- 菜单栏
Plugins → Plugin Manager → Show Plugin Manager→ 顶部显示“Plugin Manager v2.x” → 属于旧版,可配代理 - 菜单栏
Plugins → Plugins Admin→ 属于新版,无法配置代理,只能换源或离线安装
给旧版 Plugin Manager 配置 HTTP 代理
旧版 Plugin Manager 支持在配置文件中硬编码代理。它读取 %APPDATA%\Notepad++\plugins\Config\PluginManager.xml(Windows)或 ~/.notepad++/plugins/config/PluginManager.xml(Linux/macOS),需手动创建并填写。
关键点:只支持 HTTP 代理(不支持 HTTPS 代理),且必须带协议前缀、端口不可省略。常见错误包括写成 127.0.0.1:10809(缺 http://)、用 SOCKS 代理(无效)、端口填错(如 Clash 默认 HTTP 代理端口是 7890,不是 1080)。
示例配置(保存为 PluginManager.xml):
<pluginmanager><proxy>http://127.0.0.1:7890</proxy></pluginmanager>
重启 Notepad++ 后生效。如果仍失败,用 curl -x http://127.0.0.1:7890 https://raw.githubusercontent.com 在命令行验证代理是否真能通 GitHub raw 域名。
新版 Plugins Admin 无法配代理?换国内镜像源
新版 Plugins Admin 固定请求 https://github.com/notepad-plus-plus/nppPluginList/releases/download/v2.x/pluginlist.xml,不走代理也不读配置。唯一可行路径是修改 hosts 或用本地重定向——但更稳妥的是替换 XML 源为国内镜像。
目前较稳定的镜像是由社区维护的 Gitee 镜像:https://gitee.com/yangyangwithgnu/npppluginlist/raw/master/pluginlist.xml。操作方式是:
- 关闭 Notepad++
- 编辑
%APPDATA%\Notepad++\plugins\config\PluginsAdmin.xml(若不存在则新建) - 写入以下内容(注意路径大小写和引号格式):
<pluginsadmin><pluginlisturl>https://gitee.com/yangyangwithgnu/npppluginlist/raw/master/pluginlist.xml</pluginlisturl></pluginsadmin>
重启后打开 Plugins → Plugins Admin,列表应正常加载。注意该镜像更新有延迟(通常 1–3 天),新插件可能暂不可见。
代理配置生效但插件安装失败:检查证书与域名解析
即使代理通了,仍可能卡在“下载插件包失败”。常见原因有两个:
-
Plugin Manager内置的 HTTP 客户端不校验 TLS 证书,但某些企业代理会替换证书导致握手失败;此时需关闭代理的 SSL 解密功能,或换用不干预 HTTPS 的代理(如 Clash 的 TUN 模式) - GitHub raw 域名被污染或 DNS 解析异常,表现为能 ping 通 IP 但无法 GET;可在命令行执行
nslookup raw.githubusercontent.com,若返回非 GitHub 官方 IP(如 151.101.x.x),需手动改 hosts 或换 DNS(如1.1.1.1)
另外,Plugins Admin 下载插件 ZIP 包时走的是 GitHub Release 链接(https://github.com/.../releases/download/...),这个域名也常被干扰,不能只靠改 pluginlist.xml 就一劳永逸。











