PhpStorm 本身无内置 Minimap，右侧“小地图”必为 CodeGlance 插件提供；其是静态位图快照，非实时渲染，不支持点击跳转、滚动同步或缩放，仅用于粗略结构定位。
PhpStorm 本身没有内置代码缩略图（Minimap）功能，你看到的右侧“小地图”一定是 CodeGlance 插件提供的——它不是实时渲染的 canvas 视图，而是静态位图快照，不支持点击跳转、滚动同步或缩放，只用于结构粗略定位。
怎么确认当前显示的是 CodeGlance 缩略图
别被滚动条上的红/黄/蓝标记条纹误导：那是 PhpStorm 原生的错误/警告/TODO 标记，不是缩略图。真正的 CodeGlance 缩略图具备以下特征：
- 固定宽度竖条，位于编辑器最右侧（紧贴滚动条左侧），默认约 120px 宽
- 内容是灰阶或主题适配的代码块轮廓，能看到长函数、大段注释、空行分隔等结构分布
- 鼠标悬停时可能触发放大镜（但该功能不稳定，多数人反馈“几乎不出现”）
- 右下角状态栏会出现
CodeGlance图标，点击可临时开关（仅当前会话有效）
安装 CodeGlance 插件必须手动下载 ZIP 包
在 PhpStorm 2026.1+ 中，CodeGlance 已被 JetBrains 标记为 archived，插件市场默认不显示。搜索 “CodeGlance” 无结果，不是你操作错，是它被隐藏了。
- 打开
Settings → Plugins，点击右上角 ⚙️ 齿轮图标，勾选Show unstable plugins (Alpha/Beta) - 仍搜不到？说明你用的是企业内网镜像源，需改用本地安装方式
- 去官方插件页下载最新适配版：https://www.php.cn/link/70dc85deeed7896d1cd2b10ed44cb7c7 → Versions → 下载
CodeGlance-1.5.4.zip（已适配 2025.3–2026.2） - 回到
Plugins页面，点Install plugin from disk，选中 ZIP 文件，安装后必须重启 PhpStorm
启用后缩略图不显示？检查三项关键设置
装完插件 ≠ 自动显示缩略图。它默认有白名单和阈值限制，小文件、非主流后缀、低行数都会被跳过。
立即学习“PHP免费学习笔记（深入）”；
- 打开
Settings → Other Settings → CodeGlance（注意路径是Other Settings，不是Editor） - 确保
Enable CodeGlance和Show in right gutter都已勾选 - 把
Show minimap for files with more than __ lines改成100（默认是 500，很多 .php 文件根本达不到） - 检查
File types to include是否包含php、js、html等你需要的后缀；若项目用.blade.php或.vue，得手动加进去
调宽、调透明、关掉它：别碰 Editor → Appearance
Settings → Editor → Appearance 里根本没有 Show minimap 开关——那个选项只存在于 WebStorm 2026.5+ 的原生实现中，PhpStorm 全版本都不支持。所有调节必须进 Other Settings → CodeGlance。
- 宽度建议设为
80–100，窄屏用户可压到60；设太宽会挤占编辑区，影响分屏体验 - 背景透明度（
Background opacity）设70左右最平衡；低于50结构看不清，高于90反光干扰阅读 - 要彻底关闭？取消勾选
Enable CodeGlance即可，无需卸载插件；关掉后缩略图立即消失，不用重启 - 如果关了还残留，检查项目根目录是否有
.editorconfig，里面写了codeglance.enabled = true—— 这个配置会覆盖 IDE 设置
CodeGlance 的缩略图本质是静态快照，不反映代码折叠状态、不随光标更新、也不参与编译流程。它唯一价值是帮你一眼识别“这个文件哪一段特别长”，真要精确定位，还是靠 Ctrl+Shift+Alt+N（Symbol Search）或 Ctrl+F12（Structure View）更可靠。
