macOS 11.2下Hyper 3.0.2配置ZSH时PowerLevel10k与ColorLS符号显示异常如何修复

终端内PowerLevel10k、ColorLS的图标全部显示为方框占位符，本质是终端未正确加载带图标补丁的Nerd Font字体。之前更换字体时出现文字尺寸缩小、完全不生效的问题，基本都是配置路径错误、格式不匹配、未完成全量重启导致，按以下步骤操作即可解决：

一、正确安装适配的Nerd Font字体 #

• 选择带完整图标补丁的字体版本，优先选MesloLGS NF（PowerLevel10k官方推荐适配）、JetBrainsMono Nerd Font，不要选无补丁的原生开源等宽字体
• 将字体文件安装到~/Library/Fonts用户级字体目录，避免直接装到系统级字体目录出现权限加载问题
• 安装完成后打开macOS「字体册」，确认目标字体无黄色感叹号标识，记录字体的精确全称（比如是否带空格、是否有NF后缀），后续配置需要完全匹配名称

二、修正Hyper字体配置，解决换字体无效问题 #

之前换字体要么无效果、要么文字缩小的核心原因是配置不符合Hyper 3.0.2的解析规则：

• 打开Hyper唯一核心配置文件~/.hyper.js，不要依赖应用内置设置面板的可视化选项，避免配置写入不生效
• 找到配置块内的fontFamily字段，将内容替换为"安装的Nerd Font全称", 系统兜底等宽字体，参考格式为fontFamily: '"MesloLGS NF", Menlo, monospace'
  如果不把带空格的字体名用转义双引号包裹，Hyper会因为解析失败自动加载默认等宽字体，就是换字体完全无效果、文字尺寸异常的根源
• 单独调整fontSize字段为日常使用的常规大小（比如14、15号），不要跟随字体的默认渲染尺寸，避免出现换字体后整体文字缩小的情况
• 检查配置文件中已安装的Hyper插件块，确认插件没有自定义强制覆盖的fontFamily值，如有就替换为目标Nerd Font全称

三、分场景修正应用图标显示 #

• PowerLevel10k场景：完成Hyper字体配置后，按Cmd+Q完全退出Hyper再重新启动，进入ZSH终端运行p10k configure，在图标测试环节确认所有图标可正常显示后，生成新的匹配配置文件，不要直接沿用之前在其他终端环境生成的旧配置
• ColorLS场景：升级到最新版本的ColorLS，在配置中关闭内置图标强制映射的选项，让程序直接读取字体自带的图标glyph

四、遗留问题排查 #

• 字体配置修改后必须完全退出Hyper（Cmd+Q）再启动，不要只关闭窗口、新建标签页，Hyper 3.x的字体配置为启动时加载，热重载机制无法识别新安装的字体
• 不要安装可变版本（Variable）的Nerd Font，该版本在Hyper 3.0.2上存在glyph加载兼容问题，优先选择静态TTF/OTF格式的字体安装包
• 如仍有部分图标缺失，检查Nerd Font版本号，低于2.0的版本图标集不全，无法适配P10k、ColorLS的最新图标需求

内容的提问来源于stack exchange，提问作者Riffle X