tool-bar没显示或按钮错位，先确认是否装对了包：必须安装atom-ide-ui维护的tool-bar（≥1.4.0），而非已停更的atom-toolbar-config；后者在Atom 1.60+上易因API变更导致渲染异常、按钮堆叠或工具栏不出现。
tool-bar 没显示或按钮错位，先确认是否装对了包
很多人以为装了 tool-bar 就该有工具栏，结果顶部空空如也——大概率是装错了同名但已停更的旧包。Atom 社区有两个名字接近的插件：tool-bar（由 atom-ide-ui 维护，版本 ≥ 1.4.0）和早已废弃的 atom-toolbar-config。后者在 Atom 1.60+ 上极易因 API 变更导致 DOM 渲染异常、按钮重叠或整个工具栏不出现。
检查方法：Settings → Packages → 搜索 tool-bar，看作者是不是 atom-ide-ui，版本号是否 ≥ 1.4.0。如果看到的是 atom-toolbar 或 atom-toolbar-almighty，直接卸载，再用 apm install tool-bar 重装。
常见误判：
- 看到“tool-bar activated”日志就认为成功——其实它只是加载了，没按钮是因为没插件注册命令
- 在 DevTools 里搜不到
.tool-bar元素——说明根本没渲染，不是样式问题，而是包本身不兼容
按钮全挤在左上角或堆叠成一列，检查命令注册方式
tool-bar 本身不提供功能，只负责渲染其他插件注册的命令。它只识别两类命令：
- 插件在
package.json的commands字段中声明的命令（如atom-beautify:format） - 通过
atom.commands.add注册、且命名空间与已有插件一致的命令（如仿script插件写script:run）
如果你自己写了新命令但没加进 package.json，或只在控制台执行 atom.commands.dispatch，tool-bar 是看不到的。验证是否真被识别：打开 Command Palette（Ctrl+Shift+P），输入命令 ID，能搜到才可能出现在工具栏。
容易忽略的点：
- 某些插件（如
git-plus）默认不注册工具栏命令，需手动勾选其 Settings 页面里的 “Show in Tool Bar” - 主题 CSS 可能覆盖
.tool-bar button的display或flex属性，导致按钮塌陷——临时切换为one-dark-ui排查
右下角状态栏图标错位、文字重叠，根源常在 UI 主题冲突
Atom 状态栏（bottom panel）由多个插件共用同一行空间，linter-ui-default、status-bar、tool-bar 都往里塞元素。如果图标挤在一起、文字被截断，90% 是因为 UI 主题强行设了固定高度或 line-height，压垮了子元素布局。
排查路径：
- 关闭所有非必要插件，只留
status-bar和linter-ui-default，看是否恢复正常 - 换回 Atom 默认主题
one-dark-ui+one-dark-syntax，若错位消失，说明当前主题 CSS 有侵入性规则 - 检查主题的
styles.less是否写了类似.status-bar .inline-block { height: 20px; }这类硬编码尺寸
特别注意：tool-bar 和 status-bar 的 DOM 结构都依赖 flex 布局，任何父级容器被设为 display: block 或 float 都会导致整行坍缩。
中文界面插件导致菜单/工具栏文字溢出或换行异常
装了 atom-simplified-chinese-menu 后，部分菜单项或工具栏按钮文字变长，引发换行错位甚至按钮被撑开——这不是汉化包 bug，是 Atom 默认 UI 宽度未适配中文字符宽度（尤其是 macOS 上中文字体渲染占位更大）。
实操缓解方案：
- 在
~/.atom/styles.less中追加：.tool-bar button, .menu-item { white-space: nowrap; }强制单行显示 - 减小字体：Settings → Themes → UI Theme 设置里调低
Font Size（建议 ≤ 12） - 禁用汉化包的“右键菜单”模块：编辑
~/.atom/packages/atom-simplified-chinese-menu/lib/main.js，注释掉registerContextMenu相关代码，保留顶部菜单汉化即可
真正难处理的是混合环境：比如同时启用 atom-simplified-chinese-menu 和某个自定义 tool-bar.json（老版配置），后者会触发重复渲染，DOM 中出现两套 .tool-bar，样式彻底失控——这种组合从来就不被支持，必须二选一。
