手机上file://协议无法运行复杂HTML页面，因浏览器禁用本地CSS/JS加载和fetch等API；必须通过HTTP服务（如Termux+python3 -m http.server）以http://方式访问才能正常运行。
file:// 协议在手机上根本跑不起来复杂页面——不是你 HTML 写错了，是浏览器压根不让你加载本地 .css、.js 或执行 fetch()。直接点开 index.html 只能看纯 HTML 文本，样式和交互基本全废。
安卓手机手动输入 file:/// 路径打开失败的常见原因
路径开头必须是 file:///（三个斜杠），写成两个会直接跳转失败；路径中含中文或空格时，%20 编码经常失效，哪怕你写了 my%20page.html，Chrome 也可能返回空白页或 404；/storage/emulated/0/ 是内部存储根目录，但微信/QQ 接收目录、Android/data/ 子目录等路径，浏览器根本无权访问。
可行做法：
- 把
index.html和所有资源（style.css、script.js）放进/sdcard/Download/或/sdcard/Documents/ - 重命名文件夹和文件：用英文+短横线，比如
my-demo/→my-demo/index.html - 在 Chrome 地址栏粘贴完整路径：
file:///sdcard/Download/my-demo/index.html - 确认没引用外部 CDN 或跨域资源——
file://下连https://cdn.jsdelivr.net都会被拦截
iOS 上点开 index.html 显示空白或报 frame load interrupted
iOS 的 Safari 对 file:// 基本是“物理隔离”：Files App 点开 HTML，看似加载了，实则连同目录下的 main.css 都被静默拦截，控制台只报一句 Failed to load resource，毫无提示。
绕过方式有限，且都带妥协：
立即学习“前端免费学习笔记（深入）”；
- 用 iCloud Drive 存
index.html→ 在 Files App 中长按 → “在 Safari 中打开”，仅对极简页面有效 - 装 Working Copy（Git 客户端），把文件夹加为本地仓库 → 点击右上角 Web Preview → 自动起服务并生成
http://localhost:xxxx链接 - 放弃本地双击，改用 Scriptable + 小段 JS 启 HTTPServer 模块，但每次都要手动点运行，且不支持热更新
为什么推荐用 python3 -m http.server 而不是“HTML 查看器”类 App
绝大多数标榜“HTML Viewer”的 App，后台仍是走 file:// 加载，只是包装了一层 UI，JS 依然拿不到 localStorage、发不出 fetch()、import 不了 ./utils.js——它没解决根本问题。
python3 -m http.server 是真 HTTP 服务，行为和线上环境一致：
- Termux 中执行：
cd ~/storage/shared/my-project && python3 -m http.server 8000，然后浏览器打开http://localhost:8000 - 确保 Termux 已运行
termux-setup-storage授予存储权限 - Python 版本需 ≥3.7；若报错
ModuleNotFoundError: No module named 'http'，说明 Python 安装不完整 - 相对路径、ES Module、
fetch('./data.json')全部正常，这才是调试该有的样子
用微信/QQ 发送 index.html 后点不开或样式丢失
微信点开附件，调起的是腾讯文档 WebView，不是真实 Chrome 或 Safari——它会过滤掉 <script> 标签、忽略 <link rel="stylesheet">，甚至连 <img src="logo.png"> 都加载不了。
如果非得传，只能这么做：
- 把整个项目压缩成 ZIP，发过去后让对方用 ZArchiver 解压到
/sdcard/Download/ - 确保解压后目录结构扁平：
index.html、style.css、script.js在同一级 - 别指望微信里直接点开就能用；解压完仍要手动输
file:///路径，或进 Termux 起服务
file:// 是残血模式，HTTP 才是满状态。路径写对、名字改干净、服务跑起来——这三步漏任何一步，看到的都是假象。 
