Notepad++插件开发需v8.5+版本,低于v7.6无法加载新插件;SDK须从官方仓库下载并解压至无空格无中文路径;VS项目须设多字节字符集、正确配置头文件与库路径;DLL必须放入同名子文件夹且位数匹配,配置文件编码须为UTF-8无BOM。

确认 Notepad++ 版本与 SDK 兼容性
Notepad++ v8.5+ 才完整支持当前主流插件开发流程,低于 v7.6 的版本无法加载多数新插件(尤其依赖 NPPM_MSGTOPLUGIN 或 UTF-8 配置校验的)。你必须先在 Notepad++ 中按 Help → About Notepad++ 查看实际版本号。若显示 v8.4.x 或更低,不要继续配置 SDK——先升级到官网最新安装包(如 npp.8.9.7.Installer.x64.exe),否则后续编译出的 DLL 会被静默拒绝加载。
下载并解压官方 SDK 到固定路径
SDK 不是“安装”,而是手动解压后供编译器引用。从 GitHub 官方仓库获取对应版本的 SDK:https://github.com/npp-plugins/SDK/releases/tag/v8.5.4(注意:不是 Notepad++ 主仓库的源码,是独立的 SDK 仓库)。解压后得到 include/ 和 lib/ 目录,建议放在无空格、无中文的路径下,例如:D:\dev\npp-sdk\。路径含空格或中文会导致 CMake 或 VS 找不到 NppPluginLib.lib,报错 LNK1104: cannot open file 'NppPluginLib.lib'。
用 Visual Studio 创建 Win32 DLL 项目并配置头文件/库路径
新建项目时选「Win32 项目」→「DLL」,关键三步必须做对:
- 项目属性 →
General → Character Set必须设为 Use Multi-Byte Character Set(不是 Unicode);设成 Unicode 会导致FuncItem::_itemName写入乱码,菜单项不显示 -
Configuration Properties → C/C++ → General → Additional Include Directories添加:D:\dev\npp-sdk\include -
Configuration Properties → Linker → General → Additional Library Directories添加:D:\dev\npp-sdk\lib;再在Linker → Input → Additional Dependencies加:NppPluginLib.lib
漏掉任一环节,编译会失败或运行时报 entry point not found。
复制最小可运行骨架并验证 DLL 能被识别
在 src/ 下新建 PluginDefinition.cpp,粘贴标准导出函数(不要改函数名,大小写和拼写必须完全一致):
extern "C" __declspec(dllexport) void setInfo(NppData nppData) { /* 空实现即可 */ }
extern "C" __declspec(dllexport) const TCHAR* getName() { return L"MyPlugin"; }
extern "C" __declspec(dllexport) FuncItem* getFuncsArray(int* nbF) { *nbF = 0; return nullptr; }编译生成 MyPlugin.dll 后,把它放进 Notepad++ 的 plugins\MyPlugin\ 子目录(不是 plugins\ 根目录!),重启 Notepad++。如果 Plugins 菜单里出现了 MyPlugin,说明环境已通;如果没出现,优先检查:DLL 是否放错位置、位数是否匹配(x64 Notepad++ 必须用 x64 编译)、config.xml 编码是否为 UTF-8 without BOM(旧版残留配置可能含 BOM,导致插件初始化中断)。
最常被跳过的一步是:没把 DLL 放进同名子文件夹。Notepad++ 加载插件时硬性要求 plugins\<folder_name>\<folder_name>.dll</folder_name></folder_name> 结构,哪怕只有一行代码,结构不对就彻底不可见。


















