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

米侠浏览器在字体加载上确实有点“挑食”——它只认两个地方的小写 .ttf 或 .otf 字体文件：/sdcard/MiXiaBrowser/fonts/ 和 /data/data/com.moxia.browser/files/fonts/。而且还得满足几个硬性条件：文件不能带 BOM 头，必须解压到扁平目录（不能有多层嵌套），同时要在 miaoxia://flags 里把 local font loading 标志启用。最终通过 file:// 绝对路径或本地 HTTP 服务器来引用。

为什么米侠浏览器死活不认手机本地的字体？因为它默认不扫描 /sdcard/ 或应用私有目录之外的那些 .ttf/.otf，而且对路径有严格的白名单限制。就算字体文件存在、格式也对，只要没放在指定的 fonts 子目录下，浏览器一渲染就直接跳过——结果就是网页文字要么变成方块，要么空白，要么回退到系统默认字体，怎么看怎么别扭。

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

第一步：检查文件扩展名是不是纯小写的

或 。如果是 .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 就有效。简单来说，字体文件要“平铺”在 fonts 目录下。

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

安卓设备上，米侠浏览器只扫描以下两个路径中的字体文件：

和 。其他任何位置（比如 Download、Documents、甚至根目录）都不会被自动发现，更不会触发 CSS @font-face 的本地加载逻辑。

操作其实很简单：用文件管理器新建文件夹，路径必须严格写成 /sdcard/MiXiaBrowser/fonts/——注意大小写、不能有多余的空格、斜杠方向是正斜杠。然后把你的 .ttf 或 .otf 文件复制进去就行。

如果路径已经建好了，但网页还是没效果，别急——重启浏览器后，在地址栏输入 miaoxia://flags，搜索 font，找到

选项，将其设为 ，然后点击右下角的 重启。这个实验性标志没开启的话，就算字体放对了位置，浏览器也完全不理你的本地字体声明。

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

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

注意：路径中

，否则 95% 的概率会触发加载失败，而且控制台不报任何错误。比如 file:///sdcard/MiXiaBrowser/fonts/思源黑体.otf 会静默失败，必须重命名为 sourcehan.otf 这类纯英文名。

1、安装 Spartan IDE（或其他轻量级 HTTP 服务器），打开 /sdcard/MiXiaBrowser/fonts/ 目录，点击 ▶ 启动服务器，记下地址（比如 http://localhost:8080）。

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

3、在米侠浏览器中访问包含该 CSS 的 HTML 页面，字体就能正常生效了。这种方式绕过了 file:// 协议的所有限制，兼容性最好，还支持跨域字体加载。