Electron Windows疑難排解

🛠️ Electron on Windows：原生模組與打包疑難排解
NODE_MODULE_VERSION 錯誤查半天查不到清楚解法？這裡有完整診斷路徑

Electron桌面App在Windows上搭配原生（C++）模組（better-sqlite3、sharp、serialport等）時，反覆出現的那幾個痛點錯誤，根源都是同一件事：模組是綁死特定ABI版本的編譯檔案，而系統Node跟Electron內建Node是兩個不同版本。

📊 它能做什麼
用症狀對照表讓你直接定位問題，不用亂猜：

✨ 它的獨特之處
涵蓋完整打包分發流程 — 不只解決開發環境問題，也教你用 electron-builder 打成免安裝 portable exe，透過雲端硬碟分發給非技術使用者
教你怎麼跟終端使用者解釋 — 沒有簽章導致的 SmartScreen 警告該怎麼講才不會嚇到對方
源自真實production應用 — 從實際上線運作的桌面App踩過的坑整理
🚀 如何使用

⚠️ 使用須知
適合Windows上開發 Electron + 原生模組應用的開發者，尤其是第一次遇到這類編譯錯誤、想省下一輪Google搜尋+試錯的人。

Agent Name：Electron + Native Modules on Windows: Troubleshooting

Short Description：
Fix NODE_MODULE_VERSION mismatches, error C2039 compile failures, and npm allow-scripts blocks when building Electron apps with native modules (better-sqlite3, sharp, serialport) on Windows. Includes portable .exe packaging + non-technical distribution via cloud drive.

Category：Developer Tools / DevOps & Build Tools　Tags：electron, windows, native-modules, better-sqlite3, packaging