VSCode终端背景色不随主题变化，因terminal.integrated.theme仅调整ANSI色盘，真正控制底色的是必须手动配置的terminal.integrated.background字段，需写入workbench.colorCustomizations对象中。
为什么改了终端主题，背景色还是黑的
VSCode 终端的背景色不随编辑器主题变化，也不响应 terminal.integrated.theme 这个设置项——它只调整 ANSI 色盘（比如 red 显示成什么 RGB），对底色完全无效。很多人在这里卡住，反复调 UI 里的 “Terminal > Integrated > Theme”，结果发现 #000000 还是纯黑。
真正生效的是 terminal.integrated.background，必须写进 workbench.colorCustomizations 对象里：
{
"workbench.colorCustomizations": {
"terminal.integrated.background": "#0f1117",
"terminal.integrated.foreground": "#c0caf5"
}
}
注意：terminal.background 是旧写法，仍可用，但推荐用新字段名以避免歧义。
macOS / Linux 下 Zsh 启动后 .zshrc 不生效
Zsh 启动时是否加载 ~/.zshrc，取决于它是不是 login shell。VSCode 默认启动的是 non-login shell，所以即使你配了 "terminal.integrated.defaultProfile.osx": "zsh"，.zshrc 也不会自动 source。
解决办法是在 terminal.integrated.profiles.osx（或 .linux）里显式加 -l 参数：
"terminal.integrated.profiles.osx": {
"zsh": {
"path": "/bin/zsh",
"args": ["-l"]
}
}
-
-l表示 login shell，会触发~/.zshrc加载 - 别用
--login—— 某些旧版 zsh 不识别，-l兼容性更好 - 改完配置后，必须关闭所有已打开的终端标签页，再按
Ctrl+Shift+`新开，否则旧进程不会重读
Zsh 主题（如 agnoster）图标显示为方块
这是字体缺失导致的，不是主题或 VSCode 配置问题。agnoster、powerlevel10k 等主题依赖 Powerline 或 Nerd Fonts 字形来渲染箭头、分支图标等。
必须做两件事：
- 下载并安装支持 Nerd Fonts 的字体，例如
Fira Code Retina或JetBrainsMono Nerd Font - 在 VSCode 设置中指定该字体：
"terminal.integrated.fontFamily": "'Fira Code Retina', 'JetBrainsMono Nerd Font'" - 确保
"terminal.integrated.fontSize"不小于12，否则小图标糊成一片
验证方式：新开终端，输入 echo "\uE0B0" —— 如果看到右向箭头 ▸，说明字体加载成功；若显示空格或方块，就还没装对。
Windows 上 WSL 中 Zsh 终端颜色乱码或不生效
WSL 环境下，VSCode 实际调用的是 Windows 侧的 wsl.exe 子进程，而终端渲染走的是 xterm.js。此时 Zsh 的颜色输出可能被 WSL 的默认 TERM 值（如 xterm-256color）或 Windows 控制台层拦截。
关键检查点：
- 确认 WSL 内 Zsh 的
$TERM是xterm-256color（不是linux或ansi） - 在 WSL 的
~/.zshrc开头加：export TERM=xterm-256color - 禁用 WSL 的“使用 Windows 控制台”兼容模式（在 WSL 设置里关掉）
- VSCode 设置中不要用
terminal.integrated.shell.windows指向wsl.exe，而是靠terminal.integrated.defaultProfile.linux自动识别 WSL 分发版
如果用了 zsh-syntax-highlighting，它的高亮颜色依赖 ANSI 序列，TERM 错误会导致全部变白或乱码。
最常被忽略的一点：VSCode 终端的色彩表现，是 Zsh 主题 + 字体 + VSCode colorCustomizations + WSL/OS 终端层四者叠加的结果。任意一层断链，都会让颜色“看起来没生效”。调试时建议逐层关闭其他变量，比如先用纯 zsh -l 命令测试终端本身是否正常渲染颜色，再套回 VSCode。
