为什么米侠浏览器无法调用手机本地的字体文件？

米侠浏览器仅加载/sdcard/MiXiaBrowser/fonts/和/data/data/com.moxia.browser/files/fonts/目录下的小写.ttf/.otf字体，需禁用BOM、解压至扁平目录、启用miaoxia://flags中local font loading标志，并通过file://绝对路径或本地HTTP服务器引用。

米侠浏览器无法调用手机本地的字体文件，是因为它默认不加载/sdcard/或应用私有目录外的.ttf/.otf字体资源，且严格限制字体注入路径必须位于预设白名单目录内；即使字体文件存在、格式正确，若未置于指定fonts子目录下，浏览器在渲染时会直接跳过加载，导致网页文字显示为方块、空白或回退到系统默认字体。

确认字体文件是否符合准入条件

第一步：检查文件扩展名是否为纯小写 .ttf 或 .otf —— 若是 .TTF、.OTF、.Ttf 或带空格（如“思源黑体 Regular.ttf”），米侠浏览器会静默忽略，不报错也不加载。

第二步：用支持十六进制查看的文本编辑器（如Acode或Termux+vim）打开该字体文件，确认开头三字节不是 EF BB BF（UTF-8 BOM头）。虽然字体文件本身不需BOM，但若被错误添加，部分解析器会误判为文本而非二进制资源，导致加载中断。

第三步：确认字体文件未被压缩包包裹——米侠浏览器不支持从.zip/.rar中动态解压并读取字体，必须解压至目录层级中，且不能嵌套在多层子文件夹里（如/sdcard/fonts/zh/regular/SourceHanSansSC-Regular.otf 不被识别，而 /sdcard/fonts/SourceHanSansSC-Regular.otf 才有效）。

将字体放入浏览器可识别的固定路径

安卓设备上，米侠浏览器仅扫描以下两个路径中的字体文件：【/sdcard/MiXiaBrowser/fonts/】 和 【/data/data/com.moxia.browser/files/fonts/】。其他任何位置（如Download、Documents、根目录）均不会被自动发现，也不会触发CSS @font-face 的本地加载逻辑。

操作很简单：用文件管理器新建文件夹，路径必须严格为 /sdcard/MiXiaBrowser/fonts/（注意大小写、无多余空格、斜杠方向为正斜杠），然后把你的 .ttf 或 .otf 文件复制进去。

若该路径已存在但网页仍不生效，重启浏览器后，在地址栏输入 miaoxia://flags → 搜索 font → 找到 Enable local font loading 选项 → 将其设为 Enabled → 点击右下角 Relaunch 重启。【未启用此实验性标志时，即使字体放对位置，浏览器也完全忽略本地字体声明】

在网页中正确引用本地字体

方法一：使用绝对 file:// 路径（需配合已授予的存储权限）

在CSS中写：@font-face { font-family: "SourceHan"; src: url("file:///sdcard/MiXiaBrowser/fonts/SourceHanSansSC-Regular.otf"); }

注意：路径中不能含中文、空格或括号，否则95%概率触发加载失败且无控制台报错；例如 file:///sdcard/MiXiaBrowser/fonts/思源黑体.otf 会静默失败，必须重命名为 sourcehan.otf。

方法二：通过本地HTTP服务器规避协议限制（推荐）

1、安装 Spartan IDE → 打开 /sdcard/MiXiaBrowser/fonts/ 目录 → 点击 ▶ 启动服务器 → 记下地址（如 http://localhost:8080）

2、CSS中改用：src: url("http://localhost:8080/SourceHanSansSC-Regular.otf");

3、在米侠浏览器中访问含该CSS的HTML页面即可生效。此方式绕过 file:// 协议全部限制，兼容性最强，且支持跨域字体加载。