notepad++插件必须放入同名子目录（如hexeditor.dll→plugins\hexeditor\），不可放根目录；须位数匹配（64位程序配64位dll）、路径无中文/空格/+等特殊字符，且需彻底重启进程。
插件 DLL 必须放在同名子目录下，不是 plugins 根目录
Notepad++ 加载器会跳过 plugins\ 根目录里的所有 .dll 文件，哪怕文件名完全正确。它只扫描每个子目录，并要求子目录名与主 DLL 文件名（不含扩展名）**严格一致**。
常见错误包括：
-
plugins\HexEditor.dll→ 直接放根目录，加载器无视 -
plugins\HexEdit\HexEditor.dll→ 子目录名HexEdit≠ DLL 名HexEditor，静默失败 -
plugins\MarkdownViewer++\MarkdownViewerPlusPlus.dll→ 目录含+符号，旧版逻辑可能解析异常（尤其路径含中文、空格、+、&时）
验证命令（PowerShell）：
Get-ChildItem "$env:ProgramFiles\Notepad++\plugins\*" -Directory | ForEach-Object { Write-Host "$($_.Name): $((Get-ChildItem $_.FullName -Filter *.dll).Count) DLL(s)" }输出中若某目录显示 0 DLL(s)，说明路径或命名有误。
64 位 Notepad++ 和 32 位插件混用会闪退，不报错
Notepad++ 启动黑屏、进程一闪而过、Plugins 菜单消失——大概率是架构错配。64 位 Notepad++（进程名为 notepad++64.exe）无法加载任何 32 位 .dll，反之亦然。这种失败是静默的，连日志都不写。
确认方式：
- 帮助 → 关于 Notepad++ → 右下角明确标有
64-bit或32-bit - 任务管理器 → 详细信息页 → 查看运行中的进程名
- 用
Dependencies.exe（v1.14+）打开你的插件.dll→ 检查Machine Type字段是否为AMD64（64 位）或Intel 386（32 位）
GitHub Release 页面的插件包名通常带 -x64 或 -x86 后缀，必须按 Notepad++ 架构选择对应版本，不能靠文件名猜测。
Plugin Admin 菜单不出现，不是网络问题，是根本没装上
v8.0+ 的 Notepad++ 已移除旧版 PluginManager.dll，改用内置 PluginAdmin.dll，但它**不是默认安装组件**。菜单里按 Alt+P 看不到 Plugins → Plugin Admin，说明安装时没勾选「Plugin Admin」选项，或者你用的是第三方绿色版/企业定制版（常阉割该模块）。
解决路径只有两个：
- 重装官网安装包（notepad-plus-plus.org），在自定义安装步骤中**手动勾选「Plugin Admin」**（v8.5.4+ 默认勾选，但可取消）
- 确认安装来源是官网，且帮助 → 关于 Notepad++ 中右下角有
64-bit标识；否则别试图往plugins\里硬塞PluginManager.dll——它对 v8.0+ 完全无效，且无任何提示
便携版和系统安装版的 plugins 路径不能互换
便携版的 plugins 目录必须与 notepad++.exe 在同一级，例如 D:\tools\npp-portable\notepad++.exe 对应 D:\tools\npp-portable\plugins\；而系统安装版路径固定为 C:\Program Files\Notepad++\plugins\。把便携版插件复制到系统路径，或反过来，都会导致加载失败。
更隐蔽的问题：
- 部分用户把插件解压到了
%AppData%\Notepad++\plugins\—— Notepad++ 不扫描此路径 - 企业环境或某些绿色版会将插件目录重定向到注册表或配置文件，此时需检查
notepad++.ini中是否有pluginsHome=自定义项 - 插件依赖的资源（如
locale\子目录、config.xml）缺失也会导致启动时报Failed to load plugin，但菜单条目仍不出现
最容易被忽略的一点：插件目录结构一旦出错，Notepad++ 不会弹窗、不写日志、不提示——它只是当那插件不存在。重启前务必用任务管理器杀掉所有残留的 notepad++.exe 进程，否则旧内存映射可能继续干扰加载。
