悟空浏览器本地html空白页主因是file://协议被默认禁用且仅信任download目录；须手动开启“允许网站访问文件系统”权限、将文件移至纯英文路径的download文件夹，并通过文件管理器直启或规范输入file:///路径打开。
确认HTML文件是否真能被浏览器识别
悟空浏览器打开本地HTML文件后页面全白、无报错、地址栏显示file://路径但内容不渲染，说明浏览器未正确加载或解析该文件，不是代码写错，而是访问链路在第一步就中断了。
先用手机自带的文件管理器长按该HTML文件→点击「更多」→「用其他应用打开」→选择「记事本」或「文本编辑器」，确认文件能正常显示源码；若打不开或提示“无法读取”，说明文件本身损坏或被云盘虚拟化，跳过后续所有步骤，直接重生成HTML。
绕过系统权限拦截，强制启用本地文件系统
安卓与鸿蒙设备默认禁止浏览器直接读取本地HTML，即使文件在Download目录也会返回空页面；iOS则因沙盒限制，仅允许从“文件App”中通过共享表单传入。
第一步：在悟空浏览器地址栏输入 wukong://settings/content/file 并回车，进入本地文件权限页。
第二步：找到【允许网站访问文件系统】开关，设为开启（蓝色ON状态）——【此开关默认关闭，不手动开启则file://协议永远不生效】。
第三步：彻底关闭浏览器：Android用户进入任务管理器滑掉「WukongBrowser.exe」；iOS用户双击Home键上滑关闭；鸿蒙用户需额外进入「设置→应用管理→悟空浏览器→存储→强制停止」。
把HTML文件放到系统唯一认可的安全路径
悟空浏览器只信任根目录下的Download文件夹，其他路径如Documents、DCIM、微信下载目录、云盘同步子目录全部被SAF框架过滤，选中即空白。
方法一：纯英文路径+直放Download
将原文件（如“我的首页_测试版.html”）重命名为“index_test.html”，然后从QQ/邮件/微信中长按该文件→「另存为」→手动选择「内部存储→Download」→点击确认。
方法二：禁用云盘自动同步再移动
如果文件来自华为云空间、iCloud Drive或小米云服务，请先在对应App中点击该文件→「下载到本地」→等待完成后再剪切粘贴至Download目录；【切勿直接在云盘App内点击“在悟空中打开”，那只是伪链接】。
用正确方式打开file://链接
不要在悟空浏览器里点「+」新建标签页再手动输入file://路径——这种操作会触发安全策略拦截，返回空白页。
方法1：文件管理器直达
用Solid Explorer或FX File Explorer打开Download目录→长按目标HTML文件→「更多」→「在其他应用中打开」→选择「悟空浏览器」。
方法2：通过书签快捷入口
在悟空浏览器中新建一个空白标签页→点击地址栏→粘贴完整路径，例如：file:///storage/emulated/0/Download/index_test.html → 注意是三个斜杠，且路径中不能有中文、空格、括号或emoji。
这一步操作起来很简单，直接回车就行，但必须确保路径完全符合规范，否则连请求都发不出去。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
