Notepad++插件加载失败主因是Plugin Admin未安装或配置错误:需确认v8.0+已勾选安装PluginAdmin.dll、DNS解析raw.githubusercontent.com正常、Windows防火墙放行notepad++.exe、DLL架构匹配且置于同名子目录下。

局域网环境下 Notepad++ 插件加载失败,90% 不是插件问题,而是网络策略拦截或路径配置错位。直接改 hosts 或配代理基本无效——Plugin Admin 不读系统代理,也不走浏览器设置,更不支持手动填代理地址。
确认你用的是 Plugin Admin 而不是 Plugin Manager
Notepad++ v8.0+(当前主流版本)已彻底移除 PluginManager.dll,改用内置的 PluginAdmin.dll。如果你在菜单里看到 Plugins → Plugin Manager,说明你正试图调用一个根本不存在的组件。
- 打开
帮助 → 关于 Notepad++,右下角明确标着64-bit或32-bit—— 这决定了你该用哪个架构的插件,也决定了你有没有Plugin Admin - 按
Alt+P看顶部菜单是否有Plugins → Plugin Admin;没有就说明安装时没勾选该组件,第三方绿色版/企业定制版常阉割它 - 别往
plugins\目录里硬塞PluginManager.dll,它对 v8.0+ 是静默无效的,连错误提示都不会有
Plugin Admin 列表为空?先验证 raw.githubusercontent.com 是否可达
Plugin Admin 固定请求 https://github.com/notepad-plus-plus/nppPluginList/releases/download/v2.x/pluginlist.xml,失败时不报错,只显示 “No new plugins available” 或空白列表。
- 用命令行测试:运行
nslookup raw.githubusercontent.com,如果超时、返回127.0.0.1或私有网段 IP,就是 DNS 污染;临时改成8.8.8.8或1.1.1.1可快速验证 - 切手机热点试试:如果能列出插件,说明是单位/校园网出口策略限制(比如拦截
raw.githubusercontent.com域名或 443 端口),本地配代理也没用——Plugin Admin不支持任何代理配置 - 检查 Windows 防火墙:
控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙,确保notepad++.exe在「专用」和「公用」网络下都打勾
手动安装插件时 DLL 放错位置,Notepad++ 会直接跳过
Notepad++ 对插件路径结构极其敏感,放错一字符就等于没装。它不报错、不提示、不加载,只会“假装看不见”。
- 必须把
MyPlugin.dll放进plugins\MyPlugin\MyPlugin.dll(子目录名必须与 DLL 文件名主体完全一致,不含扩展名) - 不能直接丢进
plugins\根目录,也不能放在plugins\config\或plugins\download\这类子文件夹里 - 路径中含中文、空格或特殊字符(如
plugins\JSON Viewer\)易触发 Unicode 解析失败,尤其在旧版逻辑残留场景下 - 验证方式(PowerShell):
Get-ChildItem "$env:ProgramFiles\Notepad++\plugins\*" -Directory | ForEach-Object { Write-Host "$($_.Name): $((Get-ChildItem $_.FullName -Filter *.dll).Count) DLL(s)" }
64 位 Notepad++ 加载 32 位 DLL 会静默拒载甚至闪退
架构不匹配不会弹窗报错,而是让插件菜单消失、启动黑屏、或进程一闪而过。这是最隐蔽也最容易被忽略的一环。
- 任务管理器 → 「详细信息」页 → 启动 Notepad++,看进程名是
notepad++.exe(32 位)还是notepad++64.exe(64 位) - 用
Dependencies.exe(v1.14+)打开你的插件 DLL,检查「Machine Type」字段是否为AMD64(64 位)或Intel 386(32 位) - GitHub Release 页面下载插件时,认准带
-x64或-x86后缀的包;NPPJSONViewer.dll这种无后缀的包大概率是 32 位老版本 - 便携版用户注意:插件必须放在与
notepad++.exe同级的plugins\目录下,不是系统安装路径C:\Program Files\Notepad++\plugins\
局域网环境真正卡住人的,从来不是“连不上”,而是“连上了但 Notepad++ 根本不认你放的东西”。路径名大小写、子目录结构、DLL 架构、防火墙出站规则——这四点只要错一个,就全白忙。


















