VSCode无原生导出功能,需手动提取settings.json中的workbench.colorCustomizations和editor.tokenColorCustomizations对象,保存为无注释纯JSON文件供他人合并至其settings.json根对象生效。

VSCode 没有“导出当前配色方案”按钮,所谓导出,就是手动提取 workbench.colorCustomizations 和 editor.tokenColorCustomizations 这两个对象,保存为干净的 JSON 文件供他人复用。
怎么从 settings.json 里精准提取 colorCustomizations
你不能靠截图、取色或复制整个 settings.json——必须只抠出那两段配置,且确保格式合法:
-
workbench.colorCustomizations必须是settings.json的顶层字段,不能嵌套在"workbench": { ... }里面 - 如果用了条件主题写法(如
"[Dark+]": { ... }),整个对象都要保留,包括外层方括号和花括号 - 所有注释(
//或/* */)必须删光,JSON 不认注释,VSCode 加载时会静默失败 - 值必须是合法 CSS 颜色:支持
"#1e1e1e"、"rgba(30, 30, 30, 0.9)",但不支持"red"、"hsl(...)"或var(--vscode-editor-background)
为什么别人导入后颜色没生效
常见失效不是因为文件错,而是加载路径或作用域冲突:
- 对方把你的 JSON 文件直接扔进
~/.vscode/extensions/?没用。VSCode 只加载已安装的扩展主题,不读裸 JSON - 对方把内容粘贴进了工作区级
.vscode/settings.json,而用户级设置里有同名 key?工作区设置会屏蔽用户级,建议先临时删掉工作区配置测试 - 对方启用了第三方主题(如 One Dark Pro),但你的
editor.tokenColorCustomizations里只写了"comments": "#6c789d"?这属于宽泛写法,很多主题会覆盖它;更稳妥的是用 scope 数组:["comment.line", "comment.block"] - 终端颜色没变?正常。
terminal.ansi*系列配置和编辑器主题完全独立,必须单独配
如何验证自定义 token 颜色是否真被应用
别猜,用 VSCode 自带工具实锤:
- 把光标停在目标代码上(比如一个
function关键字),按Ctrl+Shift+P→ 运行Developer: Inspect Editor Tokens and Scopes - 看右上角弹窗里的
foreground值,它显示的是当前实际渲染的颜色,不是你写的配置值 - 检查下方
textMate scopes列表,确认你配置的 scope(如keyword.control.js)是否出现在链路中 - 如果 scope 出现了但颜色没变,说明更高优先级的规则(比如某个扩展主题的
tokenColors)盖掉了你;可临时换回Default Dark+测试
真正容易被忽略的点是:VSCode 对大小写极度敏感(sideBar.background 有效,sidebar.background 完全无效),而且所有自定义颜色都依赖运行时解析——没有预编译、不报错、不提醒,错了一行就整块失效。动手前先备份原 settings.json,改完 reload window 立刻验证。











