修改 settings.json 或主题 json 文件后保存即生效，无需重启 vscode；但需确保配置位置正确（如 colorcustomizations 在用户 settings.json 最外层）、颜色值格式合法、主题文件含 type 字段且 package.json 路径正确；调试主题推荐 f5 启动隔离窗口；scope 配置应取 inspect 工具返回的首个最具体项（如 support.function.console.js）。
修改后怎么立刻看到效果
改完 settings.json 或主题 JSON 文件，不用重启 VSCode，保存即生效——但前提是配置位置和格式正确。常见失效不是 VSCode 没刷新，而是你改的字段根本没被读到。
实操建议：
-
workbench.colorCustomizations和editor.tokenColorCustomizations必须放在用户settings.json的最外层对象里，不能嵌套在其他字段下 - 颜色值必须是合法字符串：
"#2d2d2d"、"rgba(45,45,45,0.9)"、"transparent"都行，但rgb(45, 45, 45)（缺引号）或red（未定义命名色）会静默失败 - 改完按
Ctrl+Shift+P→ 输入Developer: Reload Window强制重载，可排除缓存干扰
用 F5 调试模式预览完整主题文件
如果你写的是独立主题扩展（themes/*.json），F5 启动调试是最可靠的预览方式。它会开一个干净的新窗口，加载你当前项目里的主题，完全隔离主环境干扰。
注意点：
- 确保
package.json中contributes.themes正确指向你的 JSON 文件路径，比如"./themes/my-theme-color-theme.json" - 主题文件里必须有
"type": "dark"或"type": "light"字段，否则调试窗口会报错并拒绝加载 - 调试窗口中按
Ctrl+K Ctrl+T切换主题时，选不到你的主题？检查控制台是否有Failed to load color theme错误，大概率是 JSON 语法错误或缺失colors/tokenColors
为什么改了 editor.selectionHighlightBackground 还是看不见高亮
这个颜色只在「语义高亮」开启且命中条件时才渲染，不是所有选中都触发。它和 editor.wordHighlightBackground 是两套逻辑，容易混淆。
排查步骤：
- 确认
"editor.occurrencesHighlight": true（默认开启，但关了就啥也不高亮） - 临时切换到 VSCode 官方
Default Dark+主题，再测试；如果正常，说明你当前第三方主题（如 One Dark Pro）覆盖了该设置 - 有些主题把语义高亮逻辑映射到了
editor.wordHighlightBackground，可以两个字段一起设："editor.selectionHighlightBackground": "#4a4a4a", "editor.wordHighlightBackground": "#5a5a5a" - 光标停在一个变量上，但没出现高亮？检查语言模式是否正确（右下角显示的是
JavaScript还是Plain Text）
inspect 工具返回多个 scope，该信哪个
VSCode 的 TextMate scope 匹配是前缀匹配，越长越优先。当你在 console.log() 上运行 Developer: Inspect Editor Tokens and Scopes，面板顶部第一个 scope 就是你该用的。
例如返回：
scope: support.function.console.js, support.function.console, support.function
你应该配 "support.function.console.js"，而不是笼统写 "support.function"——后者会影响所有函数，包括你没想动的 Array.prototype.map 或 Python 的 print()。
关键提醒：
- 不同语言插件注册的 scope 完全不通用，JavaScript 的
keyword和 Rust 的keyword是两个东西 - 别复制整行 scope 链，只取最前面那个带语言后缀的（如
.js、.py） - scope 中含空格或括号？那是显示格式，实际配置时用纯字符串，比如
"entity.name.function.ts"不要加引号外的空格
