Customize Toolbar插件配置文件路径必须为C:\Users\用户名\AppData\Roaming\Notepad++\plugins\config\CustomizeToolbar.ini，编码需UTF-8无BOM，图标路径须绝对且含扩展名，命令ID须准确对应内置或外部工具ID，重启前需完全退出Notepad++并启用插件及勾选Custom Buttons。
Customize Toolbar 插件配置文件路径写错就白忙
插件本身不提供图形化编辑界面，所有按钮定义都靠手写配置文件，路径错一字符图标就不会出现。默认配置文件位置是 C:\Users\<user>\AppData\Roaming\Notepad++\plugins\config\CustomizeToolbar.ini</user>（注意不是 config.xml 或 shortcuts.xml），其中 <user></user> 要替换成你当前 Windows 用户名。
常见错误：把路径写成 %APPDATA%\Notepad++\plugins\config\ 后直接粘贴进资源管理器——Windows 资源管理器不解析环境变量，必须展开成完整路径；或者误进 plugins\doc\ 目录下找配置文件，那里面只有帮助文档。
- 首次启用插件后，它会自动生成一个含两个示例的
CustomizeToolbar.ini，务必先确认该文件存在且可编辑 - 文件编码必须是 UTF-8 无 BOM，否则中文菜单名会乱码或按钮不加载
- 每行一条按钮定义，格式固定为：
菜单名,命令ID,图标路径,快捷键，四项缺一不可，空字段也要留逗号
图标路径必须是绝对路径且带扩展名
Notepad++ 不支持相对路径或资源 ID 引用，custom-icon-1.bmp 这种写法只在插件作者本地测试时有效。实际使用必须写全路径，例如：C:\Icons\run-python.bmp。而且 BMP 文件必须是 24×24 或 32×32 像素，否则会被拉伸变形或显示为空白方块。
- 图标文件不能放在 Notepad++ 安装目录下（如
C:\Program Files\Notepad++\），UAC 限制会导致读取失败；推荐放用户目录，比如C:\Users\<user>\Pictures\NppIcons\</user> - 支持
.bmp和.png，但.png必须是无透明通道的（即背景为纯色），否则图标边缘发虚 - 如果图标没显示，打开 Windows 事件查看器 → Windows 日志 → 应用程序，筛选 Notepad++ 相关错误，常能看到 “Failed to load icon from …” 提示
命令ID填错等于按钮失效
Customize Toolbar 插件不识别功能名称（比如 “Run Python”），只认内部命令 ID。这些 ID 来自 Notepad++ 自身功能或你定义的外部工具，不是随便起的名字。
- 内置命令 ID 示例：
IDM_FILE_NEW（新建）、IDM_EDIT_CUT（剪切）、IDM_SEARCH_FIND（查找）——完整列表见nativeLang.xml文件 - 外部工具命令 ID 格式是
IDM_EXTERNAL_TOOLS_0、IDM_EXTERNAL_TOOLS_1……按你在Settings → External Tools中添加顺序编号，第一个工具是_0，不是_1 - 如果填了不存在的 ID（比如拼错成
IDM_FILE_NEWW），按钮会显示但点击无响应，控制台也不报错，排查起来最耗时间
重启后图标仍不显示的三个硬性条件
改完配置文件必须满足全部三项才能生效，缺一不可：Notepad++ 完全退出（任务栏和后台进程都要杀干净）、插件已启用（菜单栏出现下拉箭头图标）、Custom Buttons 已勾选（右键工具栏 → Customize Toolbar → 勾选 Custom Buttons）。
- 任务管理器里确认没有残留的
notepad++.exe进程，尤其注意隐藏图标区可能还有托盘进程 - 插件启用状态在
Plugins → Customize Toolbar → Customize…能打开才算成功加载 - 勾选 Custom Buttons 后，工具栏末尾会出现一串灰色小图标——那是占位符，真正图标只在配置正确且路径可读时才替换上去
