VSCode主题和图标包需通过扩展市场安装并手动启用，不可手动复制；安装后用Ctrl+Shift+P选择对应主题或图标主题，配置settings.json时须确保ID准确且JSON格式正确。
如何在 VSCode 中正确安装主题扩展
主题扩展必须通过 VSCode 内置的扩展市场安装，不能手动复制文件到 extensions 目录（除非是本地开发调试）。打开左侧活动栏的「扩展」图标（或按 Ctrl+Shift+X），在搜索框输入主题名，比如 One Dark Pro 或 Dracula Official，点击「安装」即可。
安装完成后，主题不会自动启用，需手动应用：按 Ctrl+Shift+P 打开命令面板，输入 Preferences: Color Theme，回车后从列表中选择目标主题。若主题未出现在列表中，说明安装未完成或扩展被禁用。
常见错误包括：
- 安装后未重启 VSCode —— 大多数主题无需重启，但个别依赖底层渲染的（如
GitHub Dark Default）可能需重载窗口（Ctrl+Shift+P→Developer: Reload Window） - 误装了仅适配旧版 VSCode 的主题（如某些已下架的
Monokai变体），导致兼容性报错Extension 'xxx' is not compatible with Code - 用户设置了
"workbench.colorTheme"为无效值（如拼写错误），会回退到默认主题且无提示
如何安装并启用图标包（File Icon Theme）
图标包和主题是两类独立扩展，需分别安装和启用。搜索关键词 file icon theme，常用的是 Material Icon Theme 或 vscode-icons。安装完成后，按 Ctrl+Shift+P 输入 Preferences: File Icon Theme 并选择启用项。
图标包生效有前提条件：
- 工作区必须是已打开的文件夹（
File > Open Folder），单个文件（File > Open File）下图标通常不显示 - 部分图标包对特定文件扩展名支持有限，例如
Material Icon Theme默认不为.env显示专属图标，需在设置中手动映射："material-icon-theme.files.associations": { "*.env": "config" } - 如果启用后仍显示默认文件图标，检查是否被其他扩展覆盖（如某些 UI 增强插件会禁用图标主题）
如何通过 settings.json 手动配置主题与图标
直接编辑配置文件可避免 GUI 操作遗漏，也便于同步多台设备。打开设置（Ctrl+,），右上角点「打开设置 (JSON)」图标，添加或修改以下字段：
{
"workbench.colorTheme": "One Dark Pro",
"workbench.iconTheme": "material-icon-theme",
"workbench.layoutControl.enabled": true
}
注意：workbench.colorTheme 和 workbench.iconTheme 的值必须与扩展发布的 ID 完全一致，可在扩展详情页 URL 中找到，例如 https://marketplace.visualstudio.com/items?itemName=PKief.material-icon-theme 的 ID 是 PKief.material-icon-theme，但配置中只需填 material-icon-theme（ID 中 @ 前的部分）。
若配置后无效，大概率是 JSON 格式错误（如末尾多逗号）、引号不匹配，或该扩展未安装成功。
为什么改了主题却只在侧边栏/编辑器生效？
VSCode 主题分三类作用域：颜色主题（workbench.colorTheme）控制整体 UI + 编辑器，文件图标主题（workbench.iconTheme）仅影响资源管理器，而编辑器内语法高亮由 editor.tokenColorCustomizations 控制，它属于语言专属配置，和主题包本身无关。
例如你装了 Atom One Dark 主题，但 TypeScript 文件中函数名仍是灰色，这不是主题问题，而是该主题未定义 function 语义令牌颜色，需手动补全：
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": ["support.function"],
"settings": { "foreground": "#61afef" }
}
]
}
这种细粒度调整极易被忽略，也是个性化效果“看起来不对”的最常见原因 —— 用户以为换主题就万事大吉，实际语法着色往往需要单独干预。
