codeglance插件安装后默认不启用，需手动进入settings > other settings > codeglance勾选“show minimap”才能在编辑器右侧显示缩略图；免费版与pro版配置独立，大文件超8192行会降级为灰色占位图。
CodeGlance 插件在 2026 年已稳定适配 IDEA 2025.3 及更高版本，但默认不启用，且新版 IDEA 的设置路径和旧版有差异——直接装完不配置，右侧不会出现缩略图。
安装后没反应？检查插件是否真正启用
很多人点完 Install 就重启 IDEA，结果编辑器右侧空空如也。这是因为：
- 插件市场里存在两个名称相近的插件：
CodeGlance（免费开源版）和CodeGlance Pro（付费增强版），二者配置入口不同，功能开关也独立 - 即使安装成功，IDEA 默认不会自动开启缩略图显示，必须手动勾选启用
- 某些企业版或教育版 IDEA（如 IntelliJ IDEA Edu）可能禁用第三方 UI 扩展，需确认
Settings > Appearance & Behavior > System Settings > Plugins中该插件状态为Enabled
验证方式：打开任意 Java 文件，右键编辑器空白处 → 查看上下文菜单中是否有 Toggle CodeGlance 选项。没有则说明插件未生效。
Settings > Other Settings > CodeGlance 配置项含义
这个路径是官方指定配置入口（不是在 Plugins 页面点齿轮图标），里面几个关键开关直接影响体验：
-
Show minimap：主开关，必须勾选，否则缩略图完全不渲染 -
Minimap width：建议设为120–160，太窄看不清结构，太宽挤压编辑区（尤其双屏横向布局时） -
Draw code preview on hover：即“放大镜”功能，鼠标悬停缩略图时显示当前区域代码快照，对长方法体定位很实用，但会轻微增加 GPU 占用 -
Ignore files matching：可填*.xml, *.yml, *.md等，避免在非代码文件上浪费渲染资源
注意：CodeGlance Pro 多出 Highlight current line 和 Smooth scrolling sync 两项，免费版不支持。
缩略图不随滚动实时更新？可能是显卡驱动或渲染后端问题
常见现象：拖动编辑器滚动条后，缩略图光标位置滞后半秒、跳变，甚至卡死不动。这不是插件 Bug，而是 IDEA 渲染管线与系统图形栈的兼容性问题：
- Windows 用户若使用 Intel 核显 + 旧版驱动（
31.0.101.4837之前），建议升级驱动或改用OpenGL渲染后端（Help > Find Action > "Switch IDE Rendering Backend"） - macOS 上启用了
Reduce transparency系统辅助功能时，缩略图动画会异常卡顿，关闭该选项即可恢复 - Linux 用户若用 X11 而非 Wayland，需确保 JVM 启动参数包含
-Dsun.java2d.xrender=true，否则缩略图可能全黑
临时验证：新建一个空项目，只打开一个 500 行以内的 Java 类，观察缩略图响应是否正常。如果 OK，说明是当前项目文件规模或特定文件类型触发了性能瓶颈。
为什么大文件（>10k 行）缩略图变灰或消失？
CodeGlance 对单文件行数做了硬性限制，默认上限是 8192 行（由插件内部 MAX_LINES_TO_RENDER 常量控制），超过即降级为灰色占位图，不渲染语法高亮，也不响应悬停预览。
- 无法通过 UI 配置修改该阈值，只能改源码重新构建（见
CodeGlance/src/main/java/com/francescomaddio/codeglance/MinimapPanel.java） - 实际开发中，这类超长文件多为生成代码（如 Protobuf 编译产物、Swagger 生成客户端），建议在
Ignore files matching中加入对应 pattern，比如**/generated/**或*Generated.java - 若必须查看，可临时拆分文件，或改用 IDEA 自带的
Structure工具窗口（Alt+7）配合折叠功能导航
真正影响效率的从来不是缩略图本身，而是你忘了它只对“人写的代码”友好——自动生成的、重复的、无结构的文本，它选择沉默，是设计使然，不是缺陷。
