图标字体在离线展项变成空白，怎样检查字体文件加载与字符覆盖

离线展项的图标字体变空白，先沿“样式声明、字体地址、请求结果、字体身份、私用区码点、可见轮廓”逐项核对。图标使用的U+E001这类私用区字符没有跨字体统一图案；即使换成另一个也含该码点的字体，也可能显示完全不同的符号。

先确定文件与环境

本文重点是离线font-face资源加载与映射身份链。附件包含原创几何图标TTF、明确的私用区映射契约与可独立打开的HTML，不含商用图标或系统字体。HTML使用相对路径加载字体，浏览器字体集合的加载状态只是一个证据，不等于目标软件已经用了正确轮廓；现场网页内核和本地控件可能支持不同路径。

操作与判断

1. 检查实际CSS或界面声明的font-family和src，按部署后的基准URL解析。不要用开发服务器地址或设计机绝对路径；大小写、子目录和打包后的资源重命名都要看最终产物。

2. 在目标工具支持的网络或资源日志中记录字体请求地址、状态、MIME和错误。断网后再打开独立测试目录，区分网络仍可访问、缓存命中与真正本地加载；没有日志时注明加载证据不全。

3. 对已落盘字体核对家族名、版本与摘要，再把内容里的真实码点与约定字形对应。不能只截“加载成功”：错误版本的图标字库可能也有U+E001，但图案含义不同。

4. 保存工程重新打开，验证字形与状态文案一起正确。若软件不支持字体资源方式，使用设计方确认的独立SVG备选，并明确哪个版本生效；不要随意挑一个私用区字符替换。

输入对照与结果边界

身份环节	附件约定	失败示例
样式家族	GeoIconFixture	CSS拼错家族名
相对地址	geo-icon.ttf	发布目录缺文件
码点映射	U+E001 → icon	加载另一版图标库

check_asset.py实际确认文件存在、HTML引用和字体映射一致，但没有启动浏览器发请求。specimen.html把加载API结果显示在页面上，用来帮助读者现场取证；fontSetCheck结果不能单独证明正在显示哪个字体，因为回退和宿主策略仍需结合轮廓与日志。私用区映射必须随资源版本一起交付。

下载并复核

原创PUA图标字体、离线加载样页、身份与映射契约、文件身份链检查、本地执行结果。

把TTF、HTML和icon-contract.json保持同一目录，按目标软件支持方式打开样页；若通过HTTP测试，应使用本地受控静态服务并记录地址。Python脚本需fontTools，只做文件与映射检查。不要把HTML内联脚本复制到不允许脚本的展项模板后仍期待状态区自动更新，应按宿主能力取证。 字体脚本需要fontTools，可在独立虚拟环境执行 python -m pip install fonttools；本次实跑版本为4.67.0，未全局安装。

已实际检查HTML资源路径、字体家族和U+E001映射。没有运行目标浏览器，也没有把字体加载API结果冒充现场渲染通过。

失败时怎样继续

字体请求成功但图标不对，先比较文件身份和PUA映射，不再围绕普通汉字缺字反复排查。只有离线失败时，检查绝对URL、跨域策略、字体解码错误或打包遗漏；只有发布后失败则核对输出资源路径。不要让系统字体fallback显示方框后再用背景遮住，它没有恢复图标功能。

交付应包含图标码点表、字体版本、使用位置与可识别的参考符号。每次更新图标库，核对原码点含义是否改变，尤其返回、确认和告警等操作符号。目标浏览器样页通过后仍需走真实交互页面，验证实际样式继承、加载时序与离线启动行为。

相关背景可看展厅更换供应商时，怎样核对工程文件能否继续维护，继续从多媒体播放专题查找相关流程；需要结合项目确认时可查看工程对接咨询。

一级出处

• cmap将码点映射至字形；缺失映射使用glyph index 0。

来源核对日期：2026-10-24。来源支持所述机制；本文合成输入与本地计算只证明所列文件及算法，不代表目标软件或现场设备已验收。