macOS iTerm2下nvim-web-devicons图标不显示问题咨询

AI 小北

2026-8-27

结论

不需要安装全部Nerd Font补丁字体，单款完整打过Nerd Font补丁的字体就足够支撑所有图标正常显示，你遇到的乱码问题是配置环节出错导致的，按以下步骤排查修复即可：

修复步骤

检查iTerm2字体配置
打开iTerm2的设置面板，进入「Profiles - Text」配置页，将普通字体和非ASCII字体都选中你安装的Big Blue Terminal Nerd Font版本。绝大多数iTerm2环境下的图标乱码都是因为只修改了普通字体、没改非ASCII字体——Nerd Font的图标字符基本都属于非ASCII区段，不单独配置就会fallback到系统其他无对应字形的字体，显示为乱码或者方块。改完完全退出iTerm2再重新打开生效。
确认字体安装包是完整补丁版本
检查你安装的字体文件名，必须是带Nerd Font Complete标识的完整版本，不要下载文件名带Mono、Windows Compatible这类后缀的裁剪版，裁剪版本会删除部分不常用字形，很容易缺失图标。
校验插件加载状态
打开Neovim运行:checkhealth nvim-web-devicons，根据输出确认插件是否被正常加载。如果nvim-tree没有自动开启图标显示，在配置中显式打开图标开关：
```
require("nvim-tree").setup({
  renderer = {
    icons = {
      show = {
        file = true,
        folder = true,
        folder_arrow = true,
        git = true,
      }
    }
  }
})
```
改完配置后重启Neovim，执行:PackerSync确保插件版本是最新稳定版。
刷新系统字体缓存
macOS下安装新字体后如果系统识别异常，在终端执行以下命令刷新字体缓存：
```
atsutil databases -removeUser && atsutil server -shutdown && atsutil server -ping
```
执行完重启终端即可。