notepad++ v7.9+要求插件子目录名与主dll文件名(不含.dll)逐字符一致,包括大小写和符号;便携版插件目录须与notepad++.exe同级,安装版默认在program files\notepad++\plugins;必须匹配架构(x86/x64),且路径中不可含中文、空格或不可见字符。

插件子目录名和 DLL 文件名必须逐字符一致
Notepad++ v7.9+ 会严格比对子目录名与主 DLL 文件名(不含 .dll 后缀),大小写、下划线、连字符都算在内。比如 ComparePlus.dll 必须放在 plugins\ComparePlus\ 下,而不是 plugins\compareplus\ 或 plugins\Compare-Plus\。Windows 文件系统虽不区分大小写,但 Notepad++ 加载器会按字节比对字符串,XMLTools 和 xmltools 被视为两个不同插件。
检查 plugins 目录路径是否匹配 Notepad++ 类型
便携版和安装版的 plugins 路径完全不同,放错位置等于没装:
- 便携版:
plugins必须与notepad++.exe同级,且右键该 exe → 属性 → 详细信息里「原始文件名」含portable - 安装版(64 位):默认是
C:\Program Files\Notepad++\plugins - 安装版(32 位):通常是
C:\Program Files (x86)\Notepad++\plugins - 企业定制版或绿色版可能通过
notepad++.ini中的pluginsDir=指定了自定义路径,需手动确认
验证 DLL 架构是否与 Notepad++ 匹配
64 位 Notepad++ 只加载 AMD64 架构 DLL,32 位只认 Intel 386;混用不会报错,而是静默跳过:
- 启动 Notepad++ → 帮助 → 关于 Notepad++,看右下角标的是
x86还是x64 - 用
Dependencies.exe(v1.14+)打开你的 DLL → 查看「Machine Type」字段 - GitHub Release 页面下载时,认准带
-x64或-x86后缀的文件 - 任务管理器 → 详细信息页 → 看进程名是
notepad++.exe(32 位)还是notepad++64.exe(64 位)
排查路径中不可见的干扰字符
路径含中文、空格、全角符号或 Unicode 控制字符时,Notepad++ 可能解析失败且不提示:
- 避免将插件目录放在桌面、文档等默认含中文用户名的路径下
- 不要用资源管理器地址栏手动输入路径后复制粘贴——容易带入不可见的零宽空格(U+200B)
- 推荐用 PowerShell 验证结构:
Get-ChildItem "$env:ProgramFiles\Notepad++\plugins\*" -Directory,观察输出的目录名是否“看起来干净” - 若曾用第三方工具重命名过目录,建议手动删除再新建,不要依赖剪切粘贴











