米侠浏览器为何无法调用手机本地字体？

米侠浏览器对字体加载有严格的限制，仅支持特定路径下的小写 .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、.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 目录下。

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

在安卓设备上，米侠浏览器仅扫描以下两个路径中的字体文件：/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（或其他轻量级 HTTP 服务器），打开 /sdcard/MiXiaBrowser/fonts/ 目录，点击 启动服务器，记录地址（如 http://localhost:8080）。

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

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