MATLAB R2012b/R2013a 在 macOS 上打開幫助文件 (Documentation) 極易卡死、白屏、CPU 100%，根因：**內嵌瀏覽器引擎 (JxBrowser/Safari WebKit) 與 macOS 版本不相容、或嘗試聯網檢查更新導致阻塞**。本文提供兩種互補方案：切換內嵌瀏覽器引擎 (官方支援) 與 防火牆封鎖 MATLAB 聯網 (暴力但有效)，並附還原指令。

方案一：切換內嵌瀏覽器引擎 (官方支援 API)

在 MATLAB **命令視窗** 執行對應版本指令：

R2013a：切換至 Mozilla 1.5 引擎 (較穩定)

com.mathworks.mlwidgets.html.HtmlComponentFactory.setBrowserProperty('JxBrowser.BrowserType', 'Mozilla15');

• ✅ 解決卡死/白屏。
• ⚠ **副作用**：選單列 (Menu Bar) 可能消失 (已知 Bug)。

R2012b：切換至 HTMLRENDERER (舊版純 Java 渲染器)

com.mathworks.mlwidgets.html.HtmlComponentFactory.setDefaultType('HTMLRENDERER');

• ✅ 解決卡死。
• ⚠ **副作用**：幫助文件外觀極醜 (無 CSS 排版、字體渲染差)、部分互動功能失效。

方案二：防火牆封鎖 MATLAB 所有網路連線 (暴力但完美保留原生介面)

1. 系統偏好設定 → 安全性與隱私 → 防火牆 → 開啟防火牆 (需解鎖)。
2. 防火牆選項 → 「+」添加 /Applications/MATLAB_R2013a.app/bin/maci64/MATLAB (或 R2012b 路徑) → 設為「封鎖所有連線」。
3. 或使用第三方防火牆 (Little Snitch、LuLu、Hands Off!) 建立規則：**封鎖 MATLAB 進程所有輸出連線**。

• ✅ 幫助文件瞬間打開、完美渲染、選單列正常、零卡頓。
• ⚠ **代價**：MATLAB 完全無法聯網 (License 驗證、Toolbox 下載、App Store、文件在線搜尋、Simulink 模型下載等全部失效)。
• 💡 **折中**：需要聯網時暫時關閉規則，用完再開啟。

還原預設引擎 (撤銷方案一)

在命令視窗執行：

% R2013a 還原
com.mathworks.mlwidgets.html.HtmlComponentFactory.setBrowserProperty('JxBrowser.BrowserType', 'Safari');

% R2012b 還原
com.mathworks.mlwidgets.html.HtmlComponentFactory.setDefaultType('HTMLPANEL');

根因深度分析

• R2012b/R2013a 使用 **JxBrowser (基於 Chromium)** 或 **Safari WebKit** 嵌入式瀏覽器渲染幫助文件 (HTML5+CSS3+JS)。
• macOS 系統更新導致 WebKit/System WebView 行為變更，JxBrowser 舊版未適配 → 死循環/記憶體洩漏/GPU 加速衝突。
• 文件頁面包含「檢查更新」JS，嘗試連線 MathWorks 伺服器 → 國內網路/代理導致長超時阻塞 UI 執行緒。

建議選擇策略

場景	推薦方案
日常開發、頻繁查閱文件、需保持介面美觀	方案二 (防火牆封鎖網路) + 需聯網時暫開
極少用幫助文件、可接受醜陋介面、不想動防火牆	方案一 (切換引擎)
離線環境/高安全環境	方案二 (天然隔離)

結語

MATLAB 舊版幫助文件卡死是 **舊版嵌入式瀏覽器 vs 新版 macOS** 的相容性債。**防火牆封鎖網路** 是最徹底、副作用最可控 (可隨時切換) 的方案；**切換引擎** 是官方提供但副作用明顯的備選。根據工作流選擇：重介面體驗 → 封網路；重純淨環境/不想動防火牆 → 換引擎。若長期使用，強烈建議升級至 R2016b+ (內建 Chrome 無頭模式，相容性大幅提升)。