notepad++自定义工具栏按钮本质是挂载已定义的外部工具命令。必须先通过“设置→外部工具→添加”定义命令，重启后才可在customize toolbar中显示并添加图标，图标不可自定义且不支持复杂交互。
外部工具定义是唯一可靠入口
Notepad++ 没有“拖拽添加按钮”或“图形化自定义工具栏”的功能。所谓“自定义按钮”，本质是把一个 外部工具 命令挂到工具栏上，前提是它必须先出现在 Run 菜单末尾。没定义外部工具，Customize Toolbar 对话框里根本看不到对应条目——不是隐藏了，是压根不存在。
操作路径固定为：设置 → 外部工具 → 添加。填入命令时注意：
-
python "$(FULL_CURRENT_PATH)"这类写法只在 CMD 能跑通的前提下才有效；更稳妥的是写绝对路径，比如"C:\Python311\python.exe" "$(FULL_CURRENT_PATH)" - 路径含空格必须用英文双引号包裹，否则启动失败
-
$(FULL_CURRENT_PATH)在文件未保存时为空字符串，会导致命令直接报错；建议先手动保存，或改用$(CURRENT_DIRECTORY)+ 文件名拼接（需配合批处理）
Customize Toolbar 只负责“显示”，不负责“执行”
勾选 Customize Toolbar 里的条目，只是让该外部工具在工具栏上多一个图标按钮，点击后仍调用同一套命令逻辑。图标本身不可自定义：固定为小齿轮或空白方块，替换 ICO 文件无效，DPI 缩放异常时可能显示为方块或不清晰。
常见误操作：
- 没重启 Notepad++ 就去点
Customize Toolbar—— 新增的外部工具不会立刻出现，必须重启才能加载进菜单和工具栏列表 - 点了按钮没反应，第一反应不是查命令，而是怀疑插件或主题问题；其实 90% 是命令路径错误，或系统 PATH 里找不到
python/node等可执行文件 - 试图给工具栏按钮单独设快捷键——Notepad++ 不提供这个接口；快捷键只能在
设置 → 管理快捷键 → 运行命令里绑定到对应菜单项
图标尺寸与工具栏可见性是两个独立开关
工具栏是否显示，由 视图 → 显示工具栏 控制；而图标大小（24px/36px/48px）则在 设置 → 首选项 → 常用 → 工具栏 → 大图标 中勾选。这两个设置互不影响，但都影响最终视觉效果。
容易忽略的细节：
- 勾选“大图标”后，部分旧版插件按钮可能被截断或错位，尤其当工具栏按钮数量较多时
- 如果使用便携版 Notepad++（配置存安装目录），修改
nddsets.ini中的TOOLBARSHOW=1和ICON_SIZE=2更稳定，避免用户配置被重置 - 高 DPI 显示器下，“大图标”可能模糊，此时建议关闭 Windows 的“允许 Windows 尝试修复应用缩放问题”选项，而非硬调 Notepad++ 设置
别信“插件能加任意按钮”的说法
像 Customize Toolbar 插件这类第三方方案，实际只是把配置文件（如 plugins\config\CustomizeToolbar.ini）读出来，生成一组灰色按钮，背后仍是调用外部工具或内置命令。它不增加新能力，只换了个界面包装。
真实限制：
- 无法绑定鼠标中键、双击、右键等复合操作
- 不能传参给命令（比如动态插入当前光标位置文本）
- 图标路径必须是本地 BMP 文件，且尺寸固定为 16×16 或 24×24，PNG/SVG 不支持
真正需要复杂交互的场景，得靠 PythonScript 插件写脚本，再把脚本注册成外部工具——工具栏按钮只是个触发入口，逻辑全在脚本里。这点很多人一开始没想明白，结果卡在按钮点了没反应，其实根本没配脚本。
