為什麼你的 HTML 檔案在 iOS「檔案」預覽裡是壞的

「檔案」預覽實際上做了什麼

Quick Look——你點下去時背後的系統預覽器——會以刻意限制的模式算繪 HTML。它的設計目標是安全地瞄一眼，不是忠實呈現：

• 外部樣式表不會載入——只有內聯樣式活得下來。
• JavaScript 永遠不執行——頁面在執行期才產生的東西，根本不存在。
• 以相對路徑引用的檔案——圖片、字體、其他頁面——一律解析不到。
• 沒有任何方式能給頁面網路存取權，就算你刻意想開也不行。

從症狀判斷問題

• 文字讀得懂、卻完全沒有樣式 → 頁面用了外部或 CDN 樣式表，被預覽忽略了。
• 整頁空白 → 頁面靠 JavaScript 算繪（AI 產生的網頁應用和圖表頁最常見）；指令碼關掉，就沒有東西可顯示。
• 螢幕上是原始碼 → 檔案在傳輸途中變成 .txt 或掉了副檔名；改回 .html 就會恢復正常處理。
• 圖片破圖 → 圖片就放在 HTML 檔案旁邊；只預覽單一檔案會把它們變成孤兒。
• 文字變亂碼（中文／日本語 成了符號）→ 檔案用的是 GB18030 或 Shift-JIS 這類舊編碼，預覽卻當成 UTF-8 讀。

解法：換一個真正會算繪的工具開

只要改用能正確算繪 HTML 的工具開啟，上面這些失敗全都會消失。OpenHTML（免費）在裝置上就能做到：把檔案分享給它——或從「檔案」直接開啟一次而不匯入——頁面就會套上樣式、跑起本機 JavaScript。

• 多檔案頁面：匯入整個資料夾或 ZIP，相對路徑才會繼續有效——參見在 iPhone 上開啟 ZIP 網頁專案。
• 舊編碼會自動偵測，中日韓文字都能正確顯示。
• 如果還是有地方不對，診斷會直接點名到底缺哪個檔案、擋了哪個資源，不必你自己猜——有辦法的話還會附上一鍵修正。

和預覽不同，當頁面真的需要它的 CDN 時，OpenHTML 允許你逐份文件開放網路存取——其他頁面則維持完全離線。

為什麼不乾脆用 Safari？

Safari 是極出色的算繪引擎，但沒有任何官方支援的方式能把本機檔案連同它的資源餵給它。變通做法是有，可是各有各的坑：單一檔案有時能靠「分享 → Safari」打開，卻會丟掉旁邊的夥伴；把檔案傳去某處託管，等於把私人資料上傳出去。對檔案來說，檢視器 App 才是那個無聊但可靠的答案——在 iPhone 上開啟 HTML 的完整指南把所有選項都比過了。