codeglance插件在idea 2026.1+中需启用“alpha versions”并确认版本兼容性才能正常安装使用；因其被标记为archived，默认不显示，须手动添加社区源或本地安装适配版zip包，并确保kotlin插件启用及minimap配置正确。
CodeGlance 插件在最新版 IntelliJ IDEA（2026.1+）中仍可正常安装使用，但默认插件市场可能不显示或安装失败——关键在于启用“Alpha versions”和确认 IDE 版本兼容性。
为什么在 Plugins 页面搜不到 CodeGlance？
IntelliJ IDEA 2023.3 起，默认插件市场只展示“稳定版（Stable）”插件；而 CodeGlance 自 2018 年后未发布新版，官方仓库已将其标记为“archived”，不再自动出现在常规搜索结果中。
- 打开
Settings > Plugins，点击右上角⚙️齿轮图标 - 勾选
Show unstable plugins (Alpha/Beta)（必须勾选） - 再在搜索框输入
CodeGlance，就能看到CodeGlance 1.5.4（最新社区维护版） - 若仍无结果，说明你用的是 JetBrains 官方托管的旧版 Marketplace（如企业内网镜像），此时应改用本地安装
安装失败提示 “Plugin 'CodeGlance' is incompatible with this installation” 怎么办？
这是最常见的报错，本质是插件 plugin.xml 中声明的 idea-version since-build 低于当前 IDE 内核版本。2026 年的 IDEA 使用的是 233.x+ 构建号，而原始 CodeGlance 声明上限为 223.*。
- 不要删插件重装——先去
Settings > Plugins > ⚙️ > Manage Plugin Repositories - 添加社区维护源：
https://plugins.jetbrains.com/plugins/list?pluginId=7275（该地址会跳转至真实 ZIP 下载页） - 或直接下载预编译包：
CodeGlance-1.5.4.zip（来自 GitHub Actions 构建产物，适配 2025.3–2026.2） - 安装时选择
Install plugin from disk，选中 ZIP 文件即可绕过版本校验 - 安装后若报
NoClassDefFoundError: kotlin/reflect/full/KClasses，说明缺少 Kotlin 运行时——需确保 IDEA 已启用内置 Kotlin 插件（Settings > Plugins > Kotlin状态为 Enabled）
安装后 minimap 不显示？检查这三项配置
插件启用 ≠ 自动显示，它默认遵循文件类型白名单和最小行数阈值。
- 打开
Settings > Other Settings > CodeGlance - 确认
Show minimap for files with more than __ lines设为100或更低（默认是 500，小文件看不到） - 检查
File types to include是否包含你当前编辑的后缀，比如java, kotlin, xml, json, ts（注意不支持.md或.yml） - 若用了 Darcula 暗色主题但 minimap 背景发灰看不清，调高
Background opacity至0.8以上
右侧 minimap 点击无响应或滚动不同步
这不是 Bug，而是渲染线程被阻塞或语法高亮未就绪导致的典型现象。
- 关闭
Settings > Editor > Color Scheme > General > Show whitespaces（空格可视化会干扰 minimap 渲染） - 禁用冲突插件：尤其避免同时启用
EditorConfig+Indent Rainbow+CodeGlance三者组合，它们共用同一段 AST 解析路径 - 若在 .kt 文件中 minimap 显示乱码（全是方块），说明 Kotlin 插件未完成初始化——重启 IDEA 后首次打开 .kt 文件前，先手动打开一个空白
.java文件触发一次语法服务加载 - macOS 用户遇到鼠标悬停无放大镜效果，检查系统级“辅助功能 > 鼠标指针”是否启用了“加粗指针”，该设置会覆盖插件的 hover 检测逻辑
真正容易被忽略的点是：CodeGlance 的 minimap 渲染依赖于 IntelliJ 的 EditorColorsManager 实时回调，一旦你自定义了 colorScheme.xml 或用了第三方主题（如 One Dark Pro），必须手动在 CodeGlance > Theme sync mode 中切换为 Force reload on theme change，否则换主题后 minimap 会卡在旧颜色方案里不动。
