根本原因是iOS/iPadOS禁用file://协议加载本地HTML资源，导致样式、脚本等相对路径资源被拦截而白屏；需通过Scriptable等App启动本地HTTP服务（如http://localhost:8080）绕过限制。
HTML5 页面打包成压缩包（如 .zip）后直接传到 iPad 上打不开，根本原因不是 HTML5 本身有问题，而是 iOS/iPadOS 对本地文件执行机制的严格限制：它不支持双击解压后直接用 Safari 或其他浏览器打开 file:// 协议的本地 HTML 文件——哪怕路径正确、文件完整，也会白屏、报错或静默失败。
为什么 Safari 打开 index.html 显示空白或“无法打开页面”
iPad 上的 Safari 默认禁用 file:// 协议加载本地资源，尤其当 HTML 引用了相对路径的 css、js、图片等文件时，跨文件读取会被拦截。即使你用“文件”App 解压后点开，Safari 实际收到的是一个无权限上下文的本地 URL，所有 fetch()、XMLHttpRequest、甚至部分 localStorage 都会失效。
常见错误现象包括：
- 页面空白，控制台显示
Not allowed to load local resource - 图标、样式丢失，Network 面板里所有
.css/.js请求状态为cancelled - 点击按钮无响应，
console.log完全不输出（因脚本未执行）
不用服务器也能在 iPad 运行 HTML5 包的实操方案
绕过 file:// 限制的核心思路是：让 HTML 文件运行在一个有合法协议（http:// 或 https://）的上下文中。无需公网服务器，iPad 自身就能充当临时 HTTP 服务端。
立即学习“前端免费学习笔记（深入）”；
推荐做法：
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 用「文件」App 解压 HTML5 压缩包到「iCloud 云盘」或「我的 iPad」根目录下（确保
index.html在最外层） - 安装轻量工具 App，例如
Scriptable（免费）、Working Copy（含内置 HTTP Server）或Pythonista（支持http.server） - 在 Scriptable 中新建脚本，运行以下命令启动服务（需开启「本地网络」权限）：
const http = require('http');
const fs = require('fs');
const url = require('url');
const port = 8080;
http.createServer((req, res) => {
const pathname = url.parse(req.url).pathname;
const filepath = `./${pathname === '/' ? 'index.html' : pathname}`;
fs.readFile(filepath, (err, data) => {
if (err) {
res.writeHead(404);
res.end('404 Not Found');
return;
}
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end(data);
});
}).listen(port);
console.log(`Server running at http://localhost:${port}`);
然后在 Safari 中访问 http://localhost:8080 即可正常加载全部资源。
压缩包结构与路径写法必须匹配 iPad 文件系统逻辑
iPad 的「文件」App 不是传统桌面文件系统，它对路径解析更接近 Web 标准而非 POSIX。若你的 HTML5 包里有如下结构：
myapp/
├── index.html
├── assets/
│ ├── style.css
│ └── main.js
└── images/
└── logo.png
那么 index.html 中的引用必须用相对路径，且不能含多余前缀：
- ✅ 正确：
<link rel="stylesheet" href="assets/style.css"> - ❌ 错误：
<link rel="stylesheet" href="./assets/style.css">（开头的./在某些服务端环境被忽略或报错） - ❌ 更错：
<link rel="stylesheet" href="/assets/style.css">（/指向根目录，非包内根）
另外，所有资源文件名必须小写、不含空格和中文——iOS 对大小写敏感，且部分 App 会自动转义中文路径导致 404。
最易被忽略的一点：iPad 上的「文件」App 默认隐藏扩展名，解压后你以为看到的是 index.html，实际可能是 index.html.txt。务必长按文件 →「重命名」→ 手动确认扩展名完整且正确。否则服务端返回的是文本内容，浏览器不会解析为 HTML。
