在 settings.json 中微调 VSCode 代码高亮颜色

想给VSCode换个顺眼的代码高亮颜色，结果发现无从下手？这很正常。毕竟，VSCode的语法高亮机制和传统编辑器不太一样，它不是靠CSS文件来控制的。直接修改主题文件或者硬编码样式，不仅容易失效，重启后还可能一切归零。

那么，正确且持久的修改姿势是什么？答案就在那个熟悉的 settings.json 配置文件里。

如何在 settings.json 中覆盖默认语法高亮颜色

简单来说，你有两套武器可以选择，它们共同决定了你屏幕上代码的颜色。

第一套是基础武器："editor.tokenColorCustomizations"。它负责控制基于词法分析的高亮，比如哪些是关键字、哪些是字符串、哪些是注释。这是最常用、也最直接的修改入口。

第二套是进阶武器："editor.semanticTokenColorCustomizations"。它控制的是语义高亮，能更智能地区分变量名、函数调用、类型引用等。不过，这套武器有个前提条件：需要语言服务器的支持，并且你得在设置里启用 "editor.semanticHighlighting": true（这个选项默认是开启的）。

这两者可以同时使用，但存在优先级：语义高亮的规则会覆盖词法高亮的规则。也就是说，如果你对同一个代码元素（比如一个变量）在两处都做了颜色定义，最终生效的会是语义高亮里的设置。

修改字符串颜色的典型写法与常见错误

说到改颜色，很多人第一个想法就是改字符串。但坑往往就从这里开始。

一个典型的误解是：只要配置 "string" 这个属性，就能一劳永逸地改变所有字符串的颜色。实际上，不同编程语言对字符串类型的划分要精细得多。举个例子，在TypeScript里，模板字符串中的插值部分，其token类型是 "string.interpolated"；而在Python里，原始字符串（raw string）可能是 "string.quoted.raw"。用错了scope名字，配置自然不生效。

那怎么才能万无一失呢？最稳妥的办法是借助VSCode自带的侦查工具。打开命令面板（Ctrl+Shift+P），运行 Developer: Inspect Editor Tokens and Scopes，然后把光标停在你想要修改的代码文本上。这时，编辑器会弹出一个详细面板，里面显示的“真实token类型”，就是你配置时需要填写的准确scope。

基于这个原则，一些常见的配置写法如下：

• 基础写法（修改所有字符串）：

  "editor.tokenColorCustomizations": {
    "strings": "#ff6b6b"
  }

  注意，这里用的是 "strings"（复数形式），而不是单数的 "string"。
• 精确控制（针对特定语言）：如果你想只为TypeScript修改字符串颜色，而其他语言保持不变，可以使用 "languageOverrides"：

  "editor.tokenColorCustomizations": {
    "languageOverrides": {
      "typescript": {
        "strings": "#e74c3c",
        "comments": "#95a5a6"
      }
    }
  }

为什么改了 settings.json 没生效？几个关键检查点

配置写好了，保存了，但编辑器里的颜色纹丝不动。这是最让人头疼的情况。别急，问题通常出在以下几个地方，按顺序排查一遍：

• 主题扩展冲突：检查你是否安装了像 Material Theme、One Dark Pro 这类功能强大的主题扩展。它们往往自带一套完整的高亮覆盖逻辑，有时会“霸道”地忽略你在 settings.json 里的自定义设置。尝试暂时禁用这些扩展，看看颜色是否恢复正常。
• 工作区设置优先级：VSCode的设置是分层的。如果你当前打开的项目根目录下有一个 .vscode/settings.json 文件（这叫工作区设置），那么它的优先级会高于你的用户全局设置。很可能你改的是用户设置，但生效的却是工作区里的另一套规则。务必确认你修改的是正确的配置文件。
• 语义高亮的前提条件：如果你配置的是 semanticTokenColorCustomizations，那么必须满足两个前提：第一，"editor.semanticHighlighting" 必须为 true；第二，你正在使用的语言扩展（比如Python、TypeScript的官方扩展）必须提供了语义令牌（semantic tokens）的支持。缺少任何一个条件，语义高亮的配置都不会被触发。
• 颜色值格式：确认你填写的颜色值是合法的十六进制格式，比如 #ff6b6b 或简写的 #f6b。VSCode的这部分设置通常不支持 rgb()、颜色名（如 red），或者带透明度的十六进制写法（如 #rrggbbaa 在旧版本中可能无效）。

自定义注释颜色时要注意作用域嵌套

注释看似简单，但在高亮配置里却是个小麻烦。因为注释有不同的种类：行注释、块注释、文档注释，甚至还有嵌套注释（比如C++里 /* 外层 /* 内层 */ 外层 */）。不同的注释类型，对应着不同的token作用域。

• 一键修改所有注释：如果你想简单粗暴地把所有注释都改成灰色，可以这样写：

  "comments": "#7f8c8d"

• 精细化控制：但如果只想修改块注释（/* */）的颜色，你就需要更精确的scope。通过 Inspect Editor Tokens and Scopes 工具查看，你会发现块注释的scope通常是 "comment.block"，而行注释（// 或 #）则是 "comment.line"。
• 处理文档注释：像Rust、Ja vaScript这样的语言，还有专门的文档注释（/// 或 /** */），它们的scope往往是 "comment.documentation"。只有针对这个scope进行配置，才能改变它们的颜色。
• 语言特定规则：当你使用 languageOverrides 时，scope名称也要遵循特定语言的规范。例如，在Ja vaScript中配置块注释，可能需要写 "comment.block.js"，而不是通用的 "comment.block"。

最后再强调一次，尤其是涉及语义高亮时，token类型不仅数量繁多，还可能随着语言扩展的更新而变化。要想实现精准的颜色控制，千万别跳过 Inspect Editor Tokens and Scopes 这一步。光靠猜测scope名字来配置，十次里有八次会是徒劳。花几秒钟侦查一下，能省去大量反复调试的时间。