Notepad++ v7.9+插件目录必须为每个插件创建同名子文件夹(如NppFTP.dll需置于plugins\NppFTP\内),不扫描根目录裸DLL;便携版路径为notepad++.exe同级plugins,安装版为C:\Program Files\Notepad++\plugins;PluginManager.dll需手动下载并放入安装目录plugins下,且位数、API版本、大小写须严格匹配。

Notepad++ 插件目录结构迁移必须手动重建,不能直接复制旧 plugins 文件夹
新版 Notepad++(v7.9+)默认不扫描 plugins 根目录下的裸 DLL,而是只加载「插件名子文件夹」内的同名 DLL。如果你把旧版的 NppFTP.dll、XMLTools.dll 直接丢进新安装目录的 plugins\ 下,它们大概率不会出现在菜单里。
迁移不是“复制粘贴”就能完事,关键在目录结构是否符合新版加载规则:
- 每个插件必须有独立子文件夹,名字必须和主 DLL 文件名完全一致(不含
.dll后缀),例如plugins\NPPJSONViewer\NPPJSONViewer.dll - 配套文件(
config.ini、lang\zh-CN.xml、icons\等)必须和 DLL 在同一子文件夹内 - 旧版可能允许多个 DLL 混在
plugins\根目录,新版会忽略它们——哪怕你确认是 64 位匹配、进程已清空 - 便携版和安装版路径不同:安装版认
C:\Program Files\Notepad++\plugins,便携版认notepad++.exe同级的plugins;别把旧版便携目录的plugins整个覆盖到新安装版下
PluginManager.dll 缺失会导致插件管理器不可用,必须手动补全
v7.6 起官方安装包不再内置 PluginManager.dll,所以即使你把插件放对了位置,菜单里也看不到 Plugins → Plugin Admin。这不是配置错误,是组件缺失。
补救步骤很明确:
- 去 GitHub
npp-plugin-manager/releases下载最新PluginManager.dll(注意大小写必须一字不差,不能是pluginmanager.dll或PluginManager-v2.4.dll) - 放进 Notepad++ 安装目录下的
plugins文件夹(不是%APPDATA%\Notepad++\plugins) - 彻底退出 Notepad++(任务栏右下角图标右键退出,任务管理器确认无
notepad++.exe进程) - 重启后,菜单才会出现
Plugins → Plugin Admin,此时才能用图形界面批量启用/禁用插件
离线环境迁移插件时,位数和 API 版本必须双重校验
在没有网络的服务器或隔离网段里迁移插件,最容易栽在两个隐性条件上:Notepad++ 架构(x86/x64)和插件声明的 API 版本。
检查方法很简单:
- 启动 Notepad++ →
帮助 → 关于 Notepad++,看标题栏写的是(32-bit)还是(64-bit);同时记下主版本号,如v8.9.7 - 插件下载页(通常是 GitHub Release)必须选标有对应架构的包,例如
NppFTP-x64.zip不能给 32 位主程序用 - 插件 release 页面写的
API version: v0.97+表示仅兼容 v8.5+;若你用的是 v7.9,则需找作者标注legacy或v7.x的构建包 - 企业定制版或某些绿色版可能禁用插件签名验证,导致
PluginManager.dll或插件 DLL 被静默跳过——这种情况下,只能换回标准安装版再操作
插件快捷键和配置残留要单独清理,否则新旧冲突
插件迁移后功能正常,不代表设置就干净。旧版插件留下的快捷键、菜单项、配置文件可能残留在用户配置目录里,干扰新版行为。
典型残留点包括:
-
%APPDATA%\Notepad++\shortcuts.xml里还存着已卸载插件的快捷键绑定,可能导致 Ctrl+Shift+X 被占用但没对应功能 -
%APPDATA%\Notepad++\plugins\config\下某些插件会自动生成配置文件(如NppFTP.ini),若新版插件不读这个路径,就会用默认值,连不上老 FTP 服务器 - 部分插件(如 Compare、TextFX)会在菜单末尾硬加条目,即使 DLL 已删,菜单项还在——得手动编辑
shortcuts.xml或重置整个配置目录 - 如果用过宏录制,旧版宏定义存在
%APPDATA%\Notepad++\backup\下,新版可能无法识别其格式,建议导出为文本再人工适配
plugins 目录里,而散落在用户配置目录各处。不清理这些,新插件看似能用,但行为经常和预期不一致。


















