针对 node-pty 原生模块的源码重编译命令。核心作用：跳过预编译二进制（prebuild）下载，用本机 node-gyp 工具链针对当前 Node 版本/架构重新编译 node-pty 的 C++ 插件。
命令拆解
| 部分 | 作用 |
|---|---|
npm rebuild | 对已安装的包重新执行 install/构建脚本（重编译 C++ addon），不重新下载包。别名 npm rb |
node-pty | 只重建这一个包；省略则重建所有含原生模块的依赖 |
--build-from-source | npm 会把它透传给 install 脚本（npm_config_build_from_source=true），prebuild-install / node-pre-gyp 识别后跳过 prebuild 下载，直接走 node-gyp 本地编译 |
为什么需要它
node-pty 是 C++ 原生模块（封装 forkpty，提供伪终端），被 VSCode 终端、各类 Web Terminal、CLI 工具广泛依赖。它的安装机制是：
prebuild-install || node scripts/install.js # 先试下载预编译，失败再源码编译
prebuild 按 Node 版本 + OS + 架构 精确匹配。以下任一不匹配就需要重编译：
- 切换 Node 版本：
NODE_MODULE_VERSION（ABI）对不上，报错The module ... was compiled against a different Node.js version - 切换 CPU 架构：Intel → Apple Silicon（x64 → arm64），或 Rosetta 下装的 x64 包
- Electron 场景：Electron 自带不同 ABI 的 Node
- 平台无 prebuild：Alpine/musl、linux-armv6l/armv7l、FreeBSD 等，
npm install时就会落到源码编译
典型症状除 ABI 报错外，还有 posix_spawnp failed、加载 .node 文件时 cannot open shared object file。
用法
# 项目内：重编译 node-pty（默认先试 prebuild）
npm rebuild node-pty
# 项目内：强制源码编译（prebuild 损坏/不存在/ABI 不匹配时用）
npm rebuild node-pty --build-from-source
# 重建所有原生模块（切 Node 大版本后常用）
npm rebuild
# 全局包里的 node-pty（如全局安装的 CLI 工具报 pty 错误）
cd $(npm root -g)/<全局包名>
npm rebuild node-pty --build-from-source其他包管理器等价写法：
yarn rebuild node-pty --build-from-source # yarn 1
pnpm rebuild node-pty # pnpm（flag 透传行为略有差异，必要时直接重 install）Electron 项目需要指定 Electron 的 headers 而不是系统 Node：
npm rebuild node-pty --runtime=electron --target=<Electron版本> --disturl=https://electronjs.org/headers
# 或者用现成工具
npx electron-rebuild -m . -w node-pty
npx electron-builder install-app-deps编译前置条件
源码编译走 node-gyp，需要本机 C/C++ 工具链：
| 平台 | 依赖 |
|---|---|
| macOS | Xcode Command Line Tools：xcode-select --install |
| Debian/Ubuntu | sudo apt-get install -y build-essential python3 |
| RHEL/Fedora | sudo dnf install -y gcc gcc-c++ make python3 |
| Alpine | apk add build-base python3 |
node-gyp 还需要 Python 3（npm config set python python3 可显式指定）。
常见报错
| 报错 | 原因与处理 |
|---|---|
was compiled against a different Node.js version / NODE_MODULE_VERSION XX !== YY | ABI 不匹配，正是本命令的适应症；重编译即可 |
gyp ERR! find Python | 缺 Python 3，装好后 npm config set python <path> |
xcrun: error: invalid active developer path | macOS CLT 丢失，xcode-select --install |
gyp WARN EACCES / permission denied, access ~/.npm | 权限问题：修复 ~/.npm 属主（chown -R $(whoami) ~/.npm），避免 sudo 安装 |
| rebuild 后仍报错 | 删干净再来：rm -rf node_modules && npm install --build-from-source=node-pty；或确认 node -v 与预期一致（nvm 场景检查当前激活版本） |
经验
- 切 Node 大版本（尤其用 nvm）后，全局 CLI 工具里捆绑的 node-pty 是重灾区——报
posix_spawnp failed时先想到重编译 - 能切回 LTS 版本解决时优先切版本（避免维护编译环境）；编译环境是一次性成本，配好后
--build-from-source最彻底 npm rebuild不会重新下载包，只重跑构建脚本，所以比重装快