serialport 是带 C/C++ 原生插件的 npm 包,安装时常遇到 node-gyp / MSBUILD 编译报错、Electron 下 ABI 不匹配等问题。本文讲清原生模块「预编译优先、本地编译兜底」的原理,以及 Windows 环境准备、手动 node-gyp 的 configure/build、Electron 场景的 electron-rebuild / electron-builder install-app-deps,并列出常见报错排查。
2026-07-28