插件更新后小地图异常，90%是原生Minimap被旧插件（如minimap-autohide、minimap-lens）覆盖或冲突；应禁用相关插件、验证monaco.editor.getConfiguration().minimap.enabled真实值，并在settings.json中显式锁定关键配置以避免覆盖。
插件更新后小地图异常，90% 是原生 Minimap 被插件覆盖或冲突，不是 VSCode 崩了，也不是配置丢了——关掉冲突插件、确认 editor.minimap.enabled 真正生效，比重装快十倍。
为什么插件一更新，小地图就变双图/点不动/直接消失？
VSCode 1.85+ 原生 Minimap 渲染逻辑已稳定，但部分插件（尤其是老版 code minimap、minimap-autohide、minimap-lens）仍会主动注入自己的渲染层。插件更新后，可能：
- 启用新钩子接管 editor.minimap.* 配置，导致你设的 clickToMoveCursor 失效
- 双渲染层叠加，造成点击偏移、滑块卡顿、缩略图模糊
- 强制把 editor.minimap.enabled 设为 true，覆盖你手动关掉的设置（右下角出现锁图标 ? 就是它干的）
验证方式：打开命令面板 Ctrl + Shift + P → 输入 Developer: Toggle Developer Tools → Console 里执行：monaco.editor.getConfiguration().minimap.enabled
返回 false 却仍看到小地图？说明有插件在“硬开”；返回 true 却看不到？说明渲染被拦截或样式被覆盖。
怎么快速定位并禁用冲突插件？
别一个个试——直接按特征筛：
- 打开扩展面板 Ctrl + Shift + X
- 搜索关键词：minimap、mini map、code minimap、lens、autohide
- 重点禁用这些典型旧插件：hoovercj.vscode-minimap、haddadz.minimap-autohide、naumovs.minimap-lens（它们大多已停更，且不兼容 VSCode 1.118 的沙箱策略）
- 禁用后按 Ctrl + R 刷新窗口（不用重启）
- 再次运行 monaco.editor.getConfiguration().minimap.enabled 确认值与表现一致
如果禁用后恢复正常，就别再启用它们——原生 Minimap 已支持 clickToMoveCursor、showSlider、renderCharacters 全部功能，无需额外插件。
settings.json 里哪些配置容易被插件悄悄改写？
插件常通过 contributes.configuration 注册默认值，优先级高于用户设置。重点关注这三行是否“被覆盖”：
- "editor.minimap.enabled"：最常被设为 true 强制开启
- "editor.minimap.renderCharacters"：插件可能设为 true 导致大型文件滚动卡顿
- "editor.minimap.scale"：某些主题插件会固定设为 2，在小屏笔记本上挤占空间
解决方法不是删插件，而是显式锁定：在用户级 settings.json 中加语言专属配置（优先级更高）：
"[javascript]": { "editor.minimap.enabled": true },<br>"[json]": { "editor.minimap.enabled": false }
这样即使插件全局启用，JSON 文件仍能保持关闭状态，避免误操作。
远程开发（SSH / Dev Container）下小地图异常怎么办？
本地设置对远程无效——你改的是本机 settings.json，VSCode 连接远程时加载的是远程机器上的配置。常见现象：
- 本地开着小地图，连上 SSH 后右侧空白
- 远程容器里点了小地图光标跳转严重偏移（尤其启用了 editor.wordWrap: "on"）
必须在远程窗口中单独操作：
- 连上远程后，按 Ctrl + , 打开设置，搜 minimap.enabled，确保勾选
- 或在远程项目根目录的 .vscode/settings.json 里补上："editor.minimap.enabled": true
- 如果偏移明显，优先关掉 renderCharacters（字符级着色会放大软换行带来的行高误差），再检查远程端字体是否为等宽连字字体（如 Fira Code），这类字体在远程渲染中常导致缩略图行高预估失准。
