vscode终端图标显示方块、问号或分隔符断裂，根本原因是系统未识别字体名或vscode未正确调用：macos需放/library/fonts/并验证字体册，linux须运行fc-cache -fv刷新，windows要确认字体管理器已注册；vscode中terminal.integrated.fontfamily必须填精确显示名称（如'meslolgs nf'），含空格加单引号，多个字体逗号分隔；还需配置shell提示符启用nerdfont-complete模式。
VSCode终端字体显示方块、问号或分隔符断裂，不是“字体没装好”，而是「系统没认出字体名」或「VSCode没按名查到字体」——哪怕.ttf文件双击安装了， macOS 会忽略 /Users/xxx/Library/Fonts/ 里的 Powerline 字体，Linux 不运行 fc-cache -fv 就等于没装，Windows 则常因旧版字体管理器跳过 Nerd Font 的 Unicode 映射表。
字体安装后系统不识别？看路径和缓存
安装 Powerline 或 Nerd Font 字体 ≠ 终端能用。关键在系统是否把它注册进字体数据库：
- macOS：必须放
/Library/Fonts/（全局）或~/Library/Fonts/（用户级），~/Downloads/或桌面双击安装可能失败；验证方式：打开「字体册」App，搜索MesloLGS NF或Cascadia Code PL，能看到才有效 - Linux：下载的
.ttf往/usr/share/fonts/truetype/或~/.local/share/fonts/放完，必须执行fc-cache -fv，否则fc-list | grep "Meslo"查不到 - Windows：双击安装后，进「设置 → 蓝牙和其他设备 → 字体」确认是否列出；若仍无效，用 PowerShell 运行
Get-Font | Where-Object {$_.Name -like "*Nerd*"}检查
terminal.integrated.fontFamily 填什么才生效
VSCode 不会自动扫描已装字体，只按你写的字符串去系统 API 查找。填错就退到 monospace，图标全变方块：
- 必须用字体「显示名称」，不是文件名：
MesloLGS NF有效，MesloLGLNerdFontComplete.ttf无效 - 含空格必须加单引号：
'MesloLGS NF'正确，MesloLGS NF会被截断为MesloLGS - 多个字体用英文逗号分隔，优先匹配前面的：
'JetBrainsMono Nerd Font', 'Cascadia Code PL', monospace - 别信“自动补全”：VSCode 设置里下拉菜单不包含 Nerd Font 名称，得手动敲，大小写、空格、标点一个都不能错
字体对了，图标还是不显示？检查 shell 提示符模式
字体只是画笔，真正输出 、 或 Powerline 箭头的是你的 shell 提示符。终端能渲染 ≠ 提示符在用：
- zsh + Powerlevel10k：必须在
~/.p10k.zsh中设typeset -g POWERLEVEL9K_MODE='nerdfont-complete'，或重跑p10k configure并选「Lean」主题+启用图标 - PowerShell + Oh My Posh：初始化命令里
--config指向的主题 JSON 必须支持 Nerd Font，例如jandedobbeleer.omp.json，且其中blocks[].font字段不能硬编码为普通字体 - bash 用户：默认
PS1不含任何 Powerline 符号，需改用powerline-shell或bash-it的 Nerd Font 插件，否则再好看的字体也只显示纯文本
最容易被忽略的其实是「shell 启动上下文」：VSCode 终端默认以非登录、非交互方式启动，$PROFILE 或 ~/.zshrc 可能根本没执行。建议在 VSCode 终端里直接运行 echo $SHELL 和 ps -p $$ 确认当前 shell 类型，再检查对应配置是否加载——很多“字体配好了但没效果”的问题，卡在这一步。
