webstorm 默认不显示顶部 toolbar，需手动勾选 view → appearance → toolbar 启用；若仍不显示，可能是全屏模式、distraction free mode 或 main menu 被隐藏，按 ctrl+shift+f12 退出即可。
WebStorm 默认不显示顶部 Toolbar，不是故障，是 JetBrains 的默认策略；勾选 View → Appearance → Toolbar 即可启用，但后续自定义必须进对设置路径、确认作用域级别，否则改了也白改。
Toolbar 怎么打开？为什么勾选了还不显示
最直接的操作就是点击顶部菜单 View → Appearance → Toolbar，勾选即可。但很多人勾完发现 Toolbar 依然没出现，常见原因有三个：
- 误入全屏模式或
Distraction Free Mode（专注模式）：按Ctrl+Shift+F12退出再试 - 整个
Main Menu（文件、编辑、视图那一栏）被隐藏了：双击Shift搜索Main menu并启用，或检查系统级全屏设置（macOS 上Use native full-screen mode开启时会压制主菜单） - Windows 系统任务栏设为“自动隐藏”，IDE 有时误判界面空间不足：临时关闭该系统设置再试
怎么往 Toolbar 加按钮？右键 Add to Main Toolbar 不够用
右键 Toolbar 空白处 → Add to Main Toolbar 只能加高频操作（如运行、调试、VCS 提交），想加 Terminal、Project、Find in Path 这类就得走正门：
- 右键 Toolbar →
Customize Toolbar - 点
+→Add Action→ 输入关键词搜索目标动作 - 添加后可拖动排序；若图标缺失（显示绿色方块），选中它点铅笔图标，指定 SVG 图标路径（推荐用 WebStorm 自带的
icons/目录下资源） - 改完必须点
OK，不是Apply—— 这个对话框不支持热应用
菜单和工具栏设置生效范围是项目级还是全局级？
这是最常被忽略的关键点：Settings 对话框左上角显示的是 Default Settings 还是 Project Settings？
- 默认进入的是
Default Settings，修改影响所有新项目 - 但如果你已在某个项目里打开 Settings，IDE 很可能自动切到
Project Settings—— 此时你改了 Toolbar，只对该当前项目生效，甚至可能完全不生效（尤其当项目配置覆盖了全局设置时） - 务必手动确认左上角标题，需要全局生效就选
Default Settings；不确定就先切过去再操作
自定义 Toolbar 后图标乱、顺序错、重启失效怎么办
这类问题基本都指向两个底层机制：
-
Customize Toolbar修改的是 UI 配置层，不写入项目配置文件，所以不会随项目 Git 提交；但也不会因项目重开而丢失 —— 前提是你没在Project Settings里误操作 - 图标显示异常（比如空白、绿色块、尺寸错位）多数是因为用了非 SVG/PNG 格式，或路径错误；WebStorm 自带图标位于
icons/子目录，路径形如$IC$/icons/terminal.svg，直接粘贴可用 - 如果某次修改后 Toolbar 完全消失，别慌：按
Ctrl+Alt+S进Appearance & Behavior → Menus and Toolbars，点对应 Toolbar 节点旁的Reset按钮即可回退到默认状态
Toolbar 表面只是几个按钮，但背后绑定的是动作注册表、UI 渲染链、作用域继承关系；改之前先确认 Default/Project 设置层级，比反复试错快得多。
