tool-bar插件本身不提供按钮，只负责渲染其他插件注册的命令；若工具栏为空，是因为未安装script、git-plus等能注册带icon/tooltip命令的插件，属正常设计而非bug。
tool-bar 插件本身不提供按钮逻辑，只负责渲染——你装了它却看不到按钮，不是配置错了，是根本没东西可渲染。
工具栏为空是因为没注册命令，不是插件没启用
tool-bar 的行为很明确：它只显示其他插件通过 atom.commands.add 注册过的命令，并且这些命令得带 icon 和 tooltip 元数据。
如果你只装了 tool-bar，没装 script、git-plus、prettier-atom 这类能“主动注册按钮”的插件，工具栏就是空的——这属于设计使然，不是 bug。
- 检查是否有插件注册了命令：按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入 “Command Palette”，看列表里有没有类似script:run、git-plus:toggle-status这样的条目 - 如果列表里有但工具栏没显示，说明该插件没给命令加
icon字段，tool-bar会跳过它 -
tool-bar不认keymap.cson里的绑定，也不认未声明图标的自定义命令
怎么让自己的命令出现在工具栏里
想加个「保存并格式化」按钮？不能只写个 atom.commands.add 就完事，必须显式调用 tool-bar 的注册接口（如果它暴露了），或者——更实际的做法——用支持该机制的插件中转。
- 推荐路径：安装
tool-bar-main或tool-bar-almighty，它们扩展了原生tool-bar，允许你在config.cson里直接声明按钮 - 手动注册需满足三项：命令标识符（如
my-package:save-and-format）、带icon的元数据、在activate()里调用atom.commands.add后，再调用toolBar.addButton（前提是目标插件提供了这个 API） - 常见失败点：
-
icon值写成"floppy-disk"（无效），正确值参考 Atom UI Icons，比如"cloud-upload" - 命令注册时漏了命名空间，写成
save-and-format而非my-package:save-and-format -
tooltip是字符串，不是对象，写成tooltip: { value: 'Save & format' }会静默失败
-
工具栏按钮点击无响应的排查顺序
按钮显示出来了，但点下去没反应？重点检查命令是否真被触发，而不是界面渲染问题。
- 打开开发者工具（
Cmd+Alt+I/Ctrl+Shift+I），在 Console 里执行：atom.commands.dispatch(atom.views.getView(atom.workspace), 'my-package:save-and-format')—— 如果报错或没效果，说明命令根本没注册成功 - 确保包已启用：在 Settings → Packages 里搜你的包名，状态必须是 “Enabled”，不是 “Disabled” 或 “Not Installed”
- 检查
package.json是否声明了commands字段，且内容与atom.commands.add中的标识符完全一致（大小写、冒号、连字符） -
tool-bar默认只监听core:*和已知插件的命名空间，自定义包若用my-package:前缀，需确认tool-bar版本 ≥ 1.4.0（旧版会过滤掉非白名单命名空间）
真正卡住多数人的地方，不是不会写代码，而是误以为 tool-bar 是个“配置即生效”的 UI 层——它其实是个被动渲染器，所有按钮都得靠别的插件喂数据。想绕过生态依赖硬上，就得自己实现一个兼容它的 provider，而不是改 menus.cson 或 keymap.cson。
