VSCode语法高亮依赖语言模式、插件选型和路径配置三要素：先确认右下角语言标识正确，再安装支持AST解析的专用插件（如hbenl.vscode-protobuf），最后严格配置protoc/swipl/dotenv等绝对路径及参数，否则tokenColorCustomizations无效。
VSCode 本身不提供“统一语法高亮配置入口”，所有智能高亮行为都由具体语言插件驱动，editor.tokenColorCustomizations 只能微调已有语法作用域的颜色，无法让没解析的代码变高亮——装错插件、语言模式不对、或 protoc 路径配错，再怎么改颜色都没用。
如何确认当前文件用了正确的语言模式
这是最常被跳过的一步：VSCode 高亮的前提是识别出语言类型。右下角显示“Plain Text”“Unknown”或错误语言（比如 .pl 文件显示 Perl），说明后续所有高亮逻辑都不会触发。
- 点击右下角语言标识（如“Plain Text”），手动选择正确语言（如“PHP”“Prolog”“Environment”）
- 若频繁出错，直接在
settings.json中强制关联："files.associations": {"*.env.*": "dotenv", "*.proto": "protobuf"} - 某些插件注册的语言 ID 和官方名不一致，比如 DotENV 插件用的是
dotenv，不是env或environment；Volar 对应vue，不是vue-html - 打开文件后语言模式未生效？检查是否在空窗口中打开单个文件——插件通常只在已打开文件夹（工作区）时加载
为什么装了插件却没高亮：典型插件选型陷阱
不是所有名字含“highlight”“syntax”“support”的插件都能提供语义级高亮。很多只做正则匹配，不解析 AST，导致 import 跳转失效、嵌套结构漏染、关键字误判。
-
hbenl.vscode-protobuf是唯一支持import跳转和跨文件校验的 Protobuf 插件；zxh404.vscode-proto3只渲染关键词，路径全标红 -
swi-prolog.vscode-swi-prolog是 SWI-Prolog 官方插件，支持模块语法和谓词跳转；其他 Prolog 插件连:- use_module(...)都解析不了 -
mikestead.dotenv正确处理KEY="value with spaces"和内联注释；dotenv-highlight把带空格的值截断成两段，高亮错位 - PHP 场景下，
bmewburn.vscode-intelephense-client提供变量作用域感知高亮；felixfbecker.php-debug不负责高亮，装了也没用
自定义颜色前先搞清 scope 是什么
editor.tokenColorCustomizations 不是万能开关，它只对已存在的语法作用域（scope）生效。你改了 "keyword"，但某语言插件把函数名标为 support.function，那函数名根本不会变色。
- 打开目标文件，把光标停在想调整的元素上（比如一个变量名）
- 按
Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens，看弹窗里显示的 scope 全名（如variable.other.property.js） - 在
settings.json中写规则时，必须完全匹配该 scope，或用通配（variable.other.*） - 别盲目抄网上示例——
string在 Python 和 Rust 里 scope 不同，comment在 Vue SFC 的<script>和<template>区域也不同
Protobuf / Prolog / DotENV 这类特殊语言的硬性配置点
它们不是装完插件就完事，有不可绕过的路径与参数配置，漏一项，高亮就卡在基础层。
-
protobuf.protocPath必须是绝对路径，Windows 用正斜杠/，不能含中文或空格；protoc版本建议 v24.4，v3.x 会崩多级-I -
swipl路径配错会导致状态栏卡在[SWI-Prolog] Starting...；macOS/Linux 要确认swipl在/usr/local/bin/swipl，不是/opt/homebrew/bin/swipl -
dotenv插件对 BOM 敏感：UTF-8 with BOM 的 .env 文件第一行会被解析为乱码，整个键值对偏移；用 VSCode 右下角编码切换 → “Save with Encoding” → “UTF-8” 清掉 BOM - Vue 文件高亮依赖 Volar 的
takeOverMode，需在settings.json开启："volar.takeOverMode": true，否则<script setup>区块仍走 TS 高亮逻辑
真正卡住人的从来不是“怎么改颜色”，而是“为什么没解析”。语言模式、插件选型、路径配置这三关没过，tokenColorCustomizations 再精细也只是给一片空白上色。
