为什么 HTML 文件在 iOS「文件」预览里是坏的

「文件」预览实际做了什么

那一下点击背后是系统预览组件 Quick Look——它以刻意受限的模式渲染 HTML,为的是安全地瞄一眼,不是还原页面:

• 外部样式表不加载——只有内联样式能活下来。
• JavaScript 从不执行——页面在运行时构建的内容一概不存在。
• 相对路径引用的文件——图片、字体、其他页面——不解析。
• 没有任何途径给页面放行网络,哪怕你愿意。

按症状判断原因

• 文字能读、样式全无 → 页面用了外部或 CDN 样式表,被预览忽略了。
• 完全空白 → 页面由 JavaScript 渲染(AI 生成的应用和图表页的典型形态);脚本不跑,就什么都没有。
• 满屏源代码 → 文件传输途中变成了 .txt 或丢了扩展名;改回 .html 就恢复正常处理。
• 图片全是裂图标 → 图片在 HTML 旁边的文件夹里;只预览单个文件等于把它们全孤立了。
• 中文/日文变成乱码符号 → 文件用的是 GB18030、Shift-JIS 等传统编码,预览按 UTF-8 硬读了。

解决:交给真正的渲染器

上面的每种故障,只要换成会正经渲染 HTML 的应用就消失了。OpenHTML(免费)在设备上完成这件事:把文件分享给它——或从「文件」只读一次、不导入——页面就带着样式渲染出来,本地 JavaScript 正常运行。

• 多文件页面:导入文件夹或 ZIP,相对路径继续可用——见 ZIP 网页项目。
• 传统编码自动识别,中日韩文字正常显示。
• 仍有问题时,诊断会点名缺的是哪个文件、拦的是哪个资源,而不是让你猜——能修的直接给一键修复。

与系统预览不同,OpenHTML 允许你按文档为真正需要 CDN 的页面放行网络——其余页面照旧完全离线。

为什么不直接用 Safari?

Safari 渲染一流,却没有受支持的方式接收「本地文件 + 它的资源」。绕路方案各有暗坑:单文件经分享打开偶尔可行,但邻居文件全丢;把文件挂到网上等于把私人数据变成了上传。对文件来说,查看器就是那个无聊但可靠的答案——各种方案的完整对比见 iPhone 打开 HTML 文件完整指南。