VSCode自定义语言小地图标记已配置，还需哪些操作使其显示？

API 探路者

2026-6-17

解决VSCode自定义语言小地图标记显示问题的步骤

关联语法作用域到语言规则
确保meta.marker.xyz的匹配规则被正确添加到自定义语言的语法定义（如tmLanguage.json或package.json的contributes.languages.grammars.patterns数组中），不能单独存在，必须成为语言语法的一部分。
修正正则匹配规则
你当前正则末尾的$会限制标记只能出现在行尾，若标记可在任意位置，需移除该行尾锚定，调整后的规则：
```
{ "name": "meta.marker.xyz", "match": "~\\[@Marker\\s*=\\s*\"(.*)\"\\s*\\]~" }
```
同时确认正则能完整匹配波浪线包裹的标记内容，避免因换行、多余字符导致匹配失败。
验证语法作用域是否生效
打开自定义语言文件，选中标记内容后：
1. 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）
2. 执行Developer: Inspect Editor Tokens and Scopes命令
3. 在弹出面板中检查是否显示meta.marker.xyz作用域，若未显示，需重新调整正则或语法关联。

确保minimap配置位置正确
确认package.json中的minimap配置位于contributes节点下，结构如下：

"contributes": {
  "minimap": {
    "markers": [
      {
        "id": "meta.marker.xyz",
        "color": "white",
        "showInMinimap": true
      }
    ]
  },
  // 其他语言贡献配置...
}