为什么Flutter Web显示缺字方框而非正常文本且数字正常？

• 字体子集树摇配置不匹配
  Flutter Web 构建阶段默认会通过字体树摇（tree-shaking）裁剪冗余字体文件、减小包体积。如果配置的字体子集白名单仅包含数字对应的Unicode码位，未覆盖中文、英文字母等常规文本字符的码位范围，就会出现非数字文字因找不到对应字形渲染为方框、数字因在保留集内正常显示的问题。很多开发者手动配置字体子集范围时，只保留了0-9对应的字符段，会直接触发该异常。
• 自定义字体加载异常但数字兜底渲染生效
  如果项目为常规文本配置了非系统默认的自定义字体，且该字体文件在Web部署环境下因路径错误、跨域CORS配置缺失出现404加载失败，同时项目配置的字体 fallback 顺序存在缺陷：将不存在的自定义中文字体排在优先级第一位，而兜底的系统字体仅内置了完整数字字形、无法覆盖项目使用的非数字字符，就会触发该问题。
• CanvasKit渲染引擎的字形缓存异常
  项目默认使用CanvasKit（Skia）渲染模式时，若首屏加载阶段未完成全量常规字符的字形缓存，仅提前缓存了数字对应的字形，就会出现非数字文本渲染为方框的情况。这类问题通常和部署的静态资源缓存策略过强、浏览器强制复用旧版字体缓存有关。
• 文本编码不匹配
  如果页面展示的非数字文本是从后端接口动态拉取的，接口返回的文本编码为GBK等非UTF-8格式，但页面全局配置的解码规则为UTF-8，就会导致非数字字符解码为无对应字形的乱码；数字因跨编码格式的字节值一致，不会出现解码错误，因此可以正常渲染。

• 打开浏览器开发者工具的网络面板，筛选font类型请求，检查是否存在字体文件404、被跨域策略拦截的加载异常
• 在页面URL后临时拼接?useHtml=true参数切换为HTML渲染模式，刷新页面验证文字是否恢复正常显示，可快速定位是否为CanvasKit渲染引擎的缓存问题
• 检查web/index.html中的全局字符集声明，确认是否配置了<meta charset="UTF-8">
• 核对项目构建脚本、字体配置文件中的树摇范围，确认是否仅保留了数字对应的字符码位

内容的提问来源于stack exchange，提问作者Himakshi Choudhary