VSCode主题/图标不生效是因settings.json中workbench.colorTheme等值与插件真实ID不匹配，需通过Extensions面板查package.json的contributes.themes.id确认；colorCustomizations须用editor.tokenColorCustomizations或semanticTokenColorCustomizations配合有效scope，多根工作区需在.code-workspace中配置settings。
VSCode 颜色插件（主题/图标）找不到配置文件，不是插件坏了，而是它根本没加载到你写的路径 —— 你改的 settings.json 里那行 workbench.colorTheme 或 workbench.iconTheme，值跟插件实际注册的主题 ID 对不上。
检查 workbench.colorTheme 值是否与插件真实 ID 一致
VSCode 不会报错“主题不存在”，只会静默回退到默认主题。常见错误是复制网上示例时用了过时或拼错的名字，比如：
-
"workbench.colorTheme": "One Dark Pro"→ 实际插件 ID 是one-dark-pro.one-dark-pro（含发布者前缀） -
"workbench.colorTheme": "Material Theme"→ 正确应为equinusocio.vsc-material-theme - 大小写、连字符、点号缺一不可；Windows 和 macOS 下某些主题还分平台后缀（如
vscode-icons-mac）
正确做法：打开 Extensions 视图 → 找到对应主题插件 → 点右下角齿轮 → “Extension Settings” → 查文档或 package.json 中的 contributes.themes.id 字段。
colorCustomizations 生效必须绑定有效 scope
直接在 settings.json 里写 "editor.foregroundColor": "#ff0000" 是无效的 —— 这属于全局 UI 颜色覆盖，不走语法高亮流程。真正影响代码着色的是 editor.tokenColorCustomizations 或 editor.semanticTokenColorCustomizations 下的 textMateRules 或 semanticTokenColors。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- scope 必须真实存在：比如想改 Python 注释颜色，不能只写
"comment"（仅 plain text 有效），得用"comment.line.hash.python"或更宽泛的"comment"+ 启用editor.tokenColorCustomizations - 验证 scope 是否生效：光标停在目标代码上 →
Ctrl+Shift+P→ 运行Developer: Inspect Editor Tokens and Scopes→ 看右侧面板列出的 scope 名 - 旧字段名已弃用：
editor.tokenColorCustomizations在新版本中优先级低于editor.semanticTokenColorCustomizations，但部分语言（如 Python）仍依赖前者
多根工作区下 .code-workspace 的颜色配置被忽略
你在用户 settings.json 里配好了主题，但打开 .code-workspace 工作区后又变回默认？因为 VSCode 对多根工作区的颜色配置有独立入口 —— 它不读用户级 colorCustomizations，而只认工作区根目录下 .code-workspace 文件里的 settings 节点。
- 手动编辑
.code-workspace，在顶层加"settings"字段（不是"extensions"或"folders"同级） - 例如：
{ "folders": [{ "path": "my-project" }], "settings": { "workbench.colorTheme": "GitHub Dark Default", "workbench.iconTheme": "vscode-icons" } } - 注意：该文件必须是合法 JSON，任何逗号遗漏或引号不闭合都会导致整块
settings被跳过
--extensions-dir 不影响主题加载路径，别混用
有人以为改了插件安装目录（--extensions-dir）就能解决主题找不到的问题，其实完全无关。主题加载路径由插件自身注册决定，和扩展文件存哪没关系 —— 只要插件已启用，VSCode 就会从其 package.json 的 contributes.themes 或 contributes.iconThemes 字段读取资源路径。
-
--extensions-dir只控制.vscode/extensions/目录位置，用于缓解 C 盘空间压力 - 主题文件实际位于插件子目录下的
themes/或icons/文件夹内，VSCode 自动解析，无需手动指定 - 如果改了
--extensions-dir后主题突然失效，大概率是你迁移插件时漏掉了某个主题插件，或新路径权限不足导致插件未加载
最常被忽略的一点：VSCode 加载主题是异步的，修改 settings.json 后不重启窗口或重载窗口（Ctrl+Shift+P → Developer: Reload Window），变更可能不触发重新注入。
