VSCode如何设置代码高亮 VSCode特定语法高亮配置

先说一个最常见的踩坑姿势：改了高亮颜色，结果半天没反应，还以为是VSCode抽风。其实多半是作用域（scope）配错了，或者把颜色写到了不该放的位置。VSCode的语法高亮只认editor.tokenColorCustomizations，跟workbench.colorCustomizations没半毛钱关系——后者管的是侧边栏、状态栏这些UI元素，对代码行内的一个token都不生效。

另一个高频问题是scope写得太笼统。比如直接来一句"scope": "keyword"，你以为能覆盖所有关键字，结果if、function、const全被套上了同一个颜色——因为不同语言里它们的TextMate scope根本不一样（keyword.control、storage.type、keyword.declaration）。盲目覆盖下去，轻则颜色串位，重则语义区分全丢了。

为什么改了 editor.tokenColorCustomizations 没反应

最普遍的原因就是配错了scope或写到了错误的配置项里。除了上面说的，还有几个容易漏掉的点：

• 务必先用 Developer: Inspect Editor Tokens and Scopes（Help → Toggle Developer Tools → 右键代码 → Inspect Editor Tokens）查一下真实的scope，别靠猜。
• 优先选带层级的scope，比如support.type.python就比support.type精准得多，不容易误伤。
• 确认当前文件右下角的语言模式没错——Python文件要是显示“Plain Text”，那所有scope都匹配不上。
• 还要注意有没有被第三方主题的semanticTokenColors覆盖掉——语义高亮的优先级比TextMate规则高，这才是很多看似配置正确却无效的隐形杀手。

如何精准修改 Python 的 self 或类型注解颜色

默认情况下，Python扩展只做基础语法高亮，像self、类型参数（比如def f(x: str)里的str）、装饰器这些都属于语义着色范畴。想单独控制它们，光靠textMateRules基本没戏——self在语法层就是个普通identifier，只有语义分析才能把它标记为variable.language.self.python这类token。

正确姿势是确保Pylance正常工作：

• 确认安装的是ms-python.pylance，光装ms-python.python可不够。
• 在settings.json里开启："python.languageServer": "Pylance"和"pylance.semanticTokens": true。
• 全局开启语义高亮："editor.semanticHighlighting.enabled": true。
• 然后通过editor.tokenColorCustomizations.experimentalSemanticTokens自定义语义token颜色，比如：

"editor.tokenColorCustomizations": {
  "experimentalSemanticTokens": {
    "variable.language.self.python": { "foreground": "#FF6B6B", "fontStyle": "italic" },
    "type.parameter.python": { "foreground": "#4ECDC4" }
  }
}

string 和 comment 颜色改了但没生效？检查这三点

字符串和注释属于基础语法元素，按理说改textMateRules就能立刻见效。要是没变，大概率卡在以下环节：

• 语言模式识别失败——右下角显示“Plain Text”或“JSONC”而非目标语言，string scope压根不会被触发。
• scope名称拼错——CSS里字符串是string.quoted.single.css，不是简单的string；JS模板字符串是string.template.js，单引号是string.quoted.single.js。拼错一个点就全白搭。
• 主题强制覆盖——某些精简主题（比如Minimal Theme）会清空所有TextMate配置，只保留semanticTokenColors。临时切回Dark+测试一下就能定位。

推荐一个兼容多数语言的写法：

{
  "scope": ["string", "string.quoted"],
  "settings": { "foreground": "#E6DB74" }
}

自定义高亮后性能变卡？别硬塞一堆 textMateRules

每条textMateRules都会增加编辑器tokenization阶段的匹配开销，尤其是当scope写成正则或通配符（比如entity.*）时，VSCode要对每个token做多次比对。大文件滚动延迟、输入卡顿、光标跳转慢，往往就是这里埋的雷。

• 避免使用.*、^.*$这类正则scope，优先用确定的静态scope名。
• 一条rule覆盖多个scope比写多条rule更高效，比如["keyword.control.js", "keyword.control.ts"]。
• 不用的rule及时删掉，尤其是调试时临时加的support.*全局覆盖。
• 语义高亮虽然更准，但依赖语言服务器实时分析，大型项目里建议关掉非必要语言的editor.semanticHighlighting.enabled。

说到底，真正影响可读性的从来不是颜色数量，而是对比度与一致性。改三四个关键scope（keyword、string、comment、function）通常就够用了，再多了反而容易视觉疲劳。