Notepad++插件安装失败主因是GUP.exe被拦截或配置不当：需配置代理（gup.exe -options或手写gupOptions.xml）、确保位数匹配、校验DLL路径及子目录名一致，并清除pluginmanager_gpup.xml缓存。
Notepad++ 插件安装失败，90% 以上不是插件本身有问题，而是 GUP.exe（即插件管理器底层更新组件）在下载阶段就被系统或网络策略拦住了——它不报错，只卡住、变灰、空白、闪退。
为什么 GUP.exe 总是连不上 raw.githubusercontent.com
GUP.exe 是 Notepad++ 内置的更新与插件下载引擎，它默认直连 raw.githubusercontent.com 和官方镜像站。但这个域名在很多环境里被静默拦截：
- 企业防火墙/代理常将该域名列入黑名单，现象是插件列表为空、进度条不动、点击安装无反应
- Windows Defender 防火墙未放行
notepad++.exe的出站连接（尤其“专用”和“公用”网络都得勾选） - 杀毒软件把
gup.exe当成下载器误杀，或隔离了它下载的临时 ZIP 包 - 国内网络环境下，
raw.githubusercontent.com延迟高甚至超时，GUP 不重试也不提示，直接放弃
GUP.exe -options 配置代理的实操要点
别信“没地方配代理”的说法——GUP 自带命令行配置入口，且配置文件极简可手写：
- 打开 Notepad++ 安装目录下的
updater\gup.exe所在文件夹，按住 Shift + 右键 → “在此处打开 PowerShell 窗口” - 运行：
.\gup.exe -options，等待弹出窗口（可能需 5–10 秒） - 填入代理地址和端口（如 Clash 默认
localhost:7890），保存后会生成updater\gupOptions.xml - 若不想开窗口，可直接新建该 XML 文件，内容仅需如下结构（注意大小写和标签闭合）：
<GUPOptions> <Proxy> <server>localhost</server> <port>7890</port> </Proxy> </GUPOptions> - 改完必须完全退出 Notepad++（任务管理器里确认
notepad++.exe进程已消失），再重启才生效
插件下载成功但“plugin package is not found”怎么办
这个错误几乎全是路径问题，和网络无关。GUP 下载的 ZIP 包其实已落盘，只是 Notepad++ 没找到解压后的正确结构：
- 去回收站或临时目录找刚下载的 ZIP 包（名字类似
NppFTP_x64.zip），用 7-Zip 或系统自带解压工具打开 - 只保留根目录下的那个
.dll文件（如NppFTP.dll），删掉所有.ini、.chm、readme等辅助文件 - 在
plugins\目录下新建同名子目录（如plugins\NppFTP\），把 DLL 放进去，确保路径为：plugins\NppFTP\NppFTP.dll - 子目录名必须和 DLL 主文件名**完全一致**（不含
.dll），大小写敏感；不能是NppFtp或nppftp - 如果 Notepad++ 安装在非默认路径（如 D:\Tools\Notepad++），GUP 下载的 ZIP 可能被解压到错误位置，务必手动挪到实际安装目录的
plugins下
最易被忽略的位数与缓存冲突点
即便路径、代理、权限全对，仍可能黑屏或插件不显示——这时候要盯死两个细节：
- 在 Notepad++ 的「帮助 → 关于 Notepad++」里看右下角：明确写着
(64-bit)还是(32-bit)，下载的插件 ZIP 必须来自对应 Assets（GitHub Release 页面里找带win-x64或win-x86的包），光看文件名带x64不作数 - 删除
%AppData%\Notepad++\plugins\config\pluginmanager_gpup.xml，这个缓存损坏会导致插件列表永远为空，即使代理已通 - 每次手动放完 DLL 后，必须彻底退出 Notepad++（包括后台进程），否则旧加载状态会残留，新插件不生效
真正卡住人的从来不是“会不会装”，而是“以为装完了，其实 DLL 孤零零躺在 plugins 根目录下”。检查一遍子目录名和 DLL 名是否完全一致，比重装十次都管用。
