Minimap 是否显示仅由 Settings → Editor → Appearance → Show minimap 复选框决定；勾选后立即生效，无需重启或点击 Apply/OK；其他操作（如右下角图标、EditorConfig、插件、配置文件误写等）均为干扰项或次要影响因素。
Show minimap这个开关没勾上，Minimap 就不会出现——这是唯一决定性条件，其他操作都是干扰项。
在哪找 Minimap 开关设置
Settings（Windows/Linux 是 Ctrl+Alt+S，macOS 是 Cmd+,）→ 左侧导航进 Editor → Appearance → 找到 Show minimap 复选框。
勾选后立即生效，不用重启、不用点 Apply/OK（WebStorm 12+ 版本已取消该按钮的强制要求）。
常见误操作：
- 在右下角点击那个小图标临时隐藏——它只作用于当前会话，重启就恢复
- 改了项目级
.idea/settings.json，但项目启用了Enable EditorConfig support，被根目录下的.editorconfig覆盖（检查.editorconfig里有没有minimap.enabled = false） - 装了第三方插件如
CodeGlance，它生成的侧边栏不是 WebStorm 原生 Minimap，关掉原生设置后它还在，容易混淆
手动编辑 settings.json 怎么写才对
如果习惯直接改配置文件，必须加这行：
"editor.minimap.enabled": true
注意几个高频错写：
-
editor.minimap.size：只调宽度，不控制显隐 -
editor.minimap.showSlider：只控制滑块是否显示，和开关无关 -
minimap.enabled（缺editor.前缀）：无效字段，WebStorm 忽略 - 写成
true字符串"true"：JSON 解析失败，整个配置项失效
开了 Minimap 却看不到？先查这三件事
不是设置没生效，而是渲染被拦截或禁用：
- 当前文件类型未被识别为代码（比如文件名漏了扩展名
.js，或 WebStorm 把它当 Plain Text 处理）——右下角语言标识应显示JavaScript、TypeScript等，不是Plain Text - 启用了高对比度主题或某些 UI 插件（如 Material Theme），覆盖了
minimap_control样式规则，导致区域空白——临时切回默认主题验证 - 显卡驱动异常或远程桌面连接（如 Windows RDP）禁用了硬件加速，Minimap 渲染层被跳过——可尝试在
Help → Find Action → "Toggle Graphics Hardware Acceleration"关一次再开一次
要不要配快捷键快速开关
WebStorm 官方不提供默认快捷键，但自己配一个很值得：
进入 Settings → Keymap，搜索 Show minimap，右键 → Add Keyboard Shortcut，比如设成 Ctrl+Alt+M。
注意别和已有快捷键冲突，尤其是别误用 Ctrl+Shift+G（那是 Go to Declaration，和 Minimap 无关）。
配完立刻可用，按一下开，再按一下关，比翻设置快得多——尤其当你经常在窄屏开会、全屏写文档、调试大文件之间切换时，这个开关的实际使用频率远超预期。
真正容易被忽略的是：Minimap 的渲染依赖文件解析状态。刚打开一个超大日志文件（比如 50MB 的 app.log），即使设置了 enabled: true，它也可能延迟数秒才出现，甚至干脆不出现——这不是 bug，是 WebStorm 主动降级渲染以保响应。这时候别急着改配置，先确认文件类型是否正确、是否真需要缩略图辅助。
