notepad++插件安装前必须确认架构（x86/x64）、主版本号（如v8.6.4）和插件api版本（如v0.98+），三者缺一不可；架构需通过“帮助→关于”确认，主版本决定api兼容性，插件发布页须严格匹配标签与版本说明。
Notepad++插件安装前必须确认的三项硬性条件
插件装不上、菜单不显示、甚至 Notepad++ 启动卡死，八成不是操作错，而是环境没对齐。三个点缺一不可：架构（x86/x64）、主版本号、插件 API 版本。
- 打开
帮助 → 关于 Notepad++，右下角明确写着(32-bit)或(64-bit)—— 这是你的 Notepad++ 架构，不是系统架构 - 主版本号如
v8.6.4决定你能用哪一代插件 API：v8.0+要求插件 API ≥v0.98；v7.9是分水岭，开始默认只扫描plugins\子目录，不再读根目录下的裸.dll - 插件发布页（如 GitHub Releases）必须选带
x64或x86标签、且注明支持对应 API 版本的包。比如ComparePlugin-v2.0.1-x64.zip不能给 32 位 Notepad++ 用，NppFTP-v0.27.3-x86.dll放进 64 位环境也必然静默失败
便携版 / 企业定制版用户特别注意的加载路径和权限
不是所有 plugins 目录都一样。路径错、权限锁、策略禁用，都会让插件根本进不了加载队列。
- 便携版的
plugins通常在解压目录下，比如D:\npp-portable\plugins；而安装版默认是C:\Program Files\Notepad++\plugins；用户配置版（如通过%AppData%\Notepad++启动）则走%AppData%\Notepad++\plugins - Windows 上若 Notepad++ 安装在
C:\Program Files\，首次运行建议右键“以管理员身份运行”一次——否则插件子目录可能因权限不足无法创建或写入 - 企业环境常见策略禁用插件签名验证，或直接屏蔽
plugins目录扫描。此时即使结构全对，插件也不会加载；需联系 IT 确认组策略是否限制了pluginAdmin或 DLL 加载行为
为什么“放对了 DLL 却没反应”？启动时按住 Shift 键看日志
Notepad++ 不报错、不弹窗、菜单空空如也？别猜，直接看它自己说的加载失败原因。
- 完全退出 Notepad++（任务管理器里清掉所有
notepad++.exe和notepad++64.exe进程，托盘图标也要右键退出） - 按住
Shift键，再双击图标启动 —— 会弹出一个黑色调试窗口，所有插件加载过程实时打印 - 重点关注类似这样的输出：
Failed to load plugin: plugins\HexEditor\HexEditor.dll (error code: 126)，其中error code: 126表示找不到依赖 DLL；error code: 193就是典型的架构不匹配（32 位 DLL 试图在 64 位进程里加载）
Plugin Admin 不可用？离线安装必须严格遵循目录结构
官网访问失败、内网无网络、或者 Plugin Admin 功能被禁用时，手动部署是唯一出路。但“把 DLL 拖进 plugins 文件夹”这个动作，从 v7.9 开始就失效了。
- 必须新建同名子目录：比如插件 DLL 叫
XMLTools.dll，就得建plugins\XMLTools\，再把XMLTools.dll放进去；若含config.xml或lang\zh-CN.xml，也一并扔进该子目录 -
设置 → 导入 → 导入插件功能虽能自动建目录，但它只复制 DLL，不处理任何附属文件。像NppFTP这种依赖libssh2.dll和config.ini的插件，用导入方式必挂 - 重启不是点“关闭再点开”，而是确保任务管理器里彻底无残留进程后再启动 —— 否则旧的插件缓存还在内存里，新放的 DLL 根本不会被重新扫描
最常被忽略的是“插件依赖未满足”这个点：DLL 文件本身能放对位置、架构也匹配，但只要缺一个它要调用的系统库或配套 DLL（比如 libeay32.dll、ssleay32.dll），整个插件就静默拒载，连日志都不一定明说。遇到这种情况，先查插件文档里的 Dependencies 小节，再挨个补全。
