Notepad++插件设置备份的核心是复制shortcuts.xml、config.xml及plugins\config\目录;安装版需备份%APPDATA%\Notepad++\下这三者,便携版则备份程序同级目录下对应文件,且须核对插件位数与版本兼容性。

Notepad++插件设置备份的核心是复制哪些文件?
插件设置不是单个文件,而是分散在多个位置的组合体。只复制 plugins 文件夹远远不够——它只含插件本体(DLL),不包含你调过的参数、启用状态、快捷键绑定或界面布局。真正需要备份的是以下三类内容:
-
shortcuts.xml:所有插件快捷键(比如 NppExec 的F6、Python Script 的Alt+Shift+X)全在这里 -
config.xml:插件是否默认启用(如 Explorer 插件的“启动时显示侧边栏”)、窗口停靠位置、工具栏按钮可见性等 UI 状态 -
plugins\config\目录:NppExec、Python Script、Compare 等插件自己的配置文件(如NppExec.ini、PythonScript.dll.xml)
漏掉任意一项,迁移后插件可能加载但“不会动”:菜单里有,快捷键没反应;侧边栏空着不显示文件树;NppExec 脚本列表变空。
便携版 vs 安装版:插件配置路径完全不同
这是最容易翻车的点。安装版(尤其是管理员安装)会把插件配置写进 %APPDATA%\Notepad++\plugins\config\,而便携版默认写进程序目录下的 plugins\config\。如果你用的是便携版却去备份了 %APPDATA% 里的内容,新机器上一运行还是初始状态。
确认当前模式的方法很简单:打开 Notepad++ → ? → Debug info → 查看 “Config directory” 一行。输出是 C:\path\to\notepad++.exe\ 就是便携模式;是 C:\Users\XXX\AppData\Roaming\Notepad++ 就是安装版。
对应备份路径:
- 安装版:备份
%APPDATA%\Notepad++\shortcuts.xml、%APPDATA%\Notepad++\config.xml、%APPDATA%\Notepad++\plugins\config\ - 便携版:备份同级目录下的
shortcuts.xml、config.xml、plugins\config\
插件本身要不要一起备份?怎么判断兼容性?
要,但必须核对位数和版本。x86 插件在 x64 Notepad++ 中完全不加载(连错误提示都没有),只会静默跳过。常见错误现象是:Plugin Admin 显示已安装,但菜单里找不到对应项。
验证方法:
- 用
file命令或dumpbin /headers plugin.dll查 PE 头,确认是x64还是x86 - 检查插件作者页面是否标注支持 Notepad++ v8.x(v7.9+ 后插件接口有变动,旧插件可能崩溃)
- 便携版若用了
doLocalConf.xml或nppPortableMode.xml,确保插件 DLL 放在plugins\下,且子目录名与插件名一致(如plugins\NppExec\NppExec.dll)
别直接复制整个 plugins 文件夹到新版 Notepad++:v8 默认禁用未签名插件,需手动在 Settings → Import → Import plugin(s) 中重新导入并勾选信任。
迁移后插件不生效?先关 session.xml 再重启
很多人迁移完发现插件菜单空白、快捷键失灵,第一反应是重装插件——其实大概率是 session.xml 搞的鬼。这个文件记录的是上次退出时打开的标签页和插件窗口状态(比如 Python Script 控制台是否展开)。如果它引用了旧路径下的插件配置或 DLL,Notepad++ 启动时会卡在加载阶段,导致部分插件初始化失败。
安全做法:
- 迁移前,在原机器上正常退出 Notepad++(不要强制结束)
- 迁移时,**跳过
session.xml不复制** - 首次在新环境启动后,让它生成新的
session.xml,再手动恢复你需要的插件窗口布局
这个细节极容易被忽略:因为 session.xml 和 shortcuts.xml 都在同一个目录下,手抖全选复制就中招。


















