VSCode终端显示方块、问号或缺失图标，根本原因在于字体未被系统识别或VSCode未正确调用：需确保字体安装到系统指定路径（macOS放/Library/Fonts/、Linux运行fc-cache -fv刷新、Windows双击安装）、VSCode中terminal.integrated.fontFamily填入精确显示名称（如'MesloLGS NF'，含引号与空格）、并配置shell提示符启用nerdfont-complete模式。
字体安装不等于终端能用
VSCode 终端显示方块、问号或缺失图标（比如 、、），不是因为没装 Powerline 字体，而是字体没被系统真正识别或 VSCode 没正确调用。Windows/macOS/Linux 都存在字体路径未生效的问题：macOS 要求字体必须放在 /Library/Fonts/（用户级）或 /System/Library/Fonts/（系统级）；Linux 通常需运行 fc-cache -fv 刷新缓存；Windows 双击安装后，部分旧版字体管理器会跳过 Nerd Font 的 Unicode 映射表，导致符号区无法命中。
VSCode 设置里填的字体名必须精确匹配
在 VSCode 设置中搜索 terminal.integrated.fontFamily，填入的字符串不是文件名（如 MesloLGLNerdFontComplete.ttf），也不是随便写的别名，而是字体的「显示名称」——即系统字体册里看到的那个名字。常见错误包括：
- 漏掉空格或大小写错误：填
Meslo LG M DZ for Powerline有效，但meslo lg mdz for powerline或MesloLGMDZforPowerline会失败 - 没加引号：含空格的字体名必须用单引号包裹，例如
'Fira Code Retina'，否则 VSCode 解析时截断为Fira - 多个字体用英文逗号分隔，且前面优先匹配：
'JetBrainsMono Nerd Font', 'Cascadia Code PL', monospace - 别信“自动检测”：VSCode 不会扫描所有已安装字体，只按你写的名称去系统字体 API 查找，查不到就退到
monospace
终端能渲染图标 ≠ shell 提示符会用它
装对字体只是第一步。Powerline 分隔符（如 ）、Nerd Font 图标（如 、）是否显示，最终取决于你的 shell 是否输出了对应 Unicode 码点，以及提示符主题是否启用了 Nerd Font 模式。典型场景：
- 用
zsh+Powerlevel10k：必须在~/.p10k.zsh中确认有typeset -g POWERLEVEL9K_MODE='nerdfont-complete'，或运行p10k configure时选 “Lean” 主题并启用图标 - 用 PowerShell +
Oh My Posh：初始化命令里要带--config指向支持 Nerd Font 的主题（如jandedobbeleer.omp.json），且该 JSON 文件中blocks[].font字段需设为"Nerd Font"或留空（依赖全局 fallback） - bash 用户容易忽略：默认
PS1不含任何 Powerline 符号，得手动集成powerline-shell或改用bash-it的 Nerd Font 插件
快速验证三步法，别靠重启猜
改完配置后不用关 VSCode，直接在集成终端里跑这三条命令：
-
echo -e "\uf489 \ue70f \ue0b0"—— 应分别显示 、、；若全是方块，字体名或安装路径错了 -
ps -p $PPID | grep -q "login" && echo "login shell" || echo "non-login"—— Oh My Posh / Powerlevel10k 依赖 login shell 加载 profile，非 login 模式下$PROFILE或~/.zshrc可能根本没执行 -
code --list-extensions | grep -i terminal—— 确保没装冲突插件（如某些“Terminal Enhancer”会劫持 font 渲染链）
最常被跳过的环节是：以为字体设置生效了，其实 VSCode 仍在用 Windows Terminal 或 iTerm2 的字体缓存；或者 shell 启动后没重载配置，直接复用旧进程。字体和提示符是两层独立系统，缺一不可。
