在 CentOS 上进行 Node.js 跨平台开发的可落地方案
一 环境与工具链准备
- 使用 NVM 管理多版本 Node.js，便于在 Windows/macOS/Linux 保持一致的开发与测试矩阵；在 CentOS 上安装与切换版本非常高效。
- 安装构建工具链，满足原生模块（Native Addon）编译需求：
- CentOS/RHEL：sudo yum groupinstall “Development Tools” && sudo yum install python3
- Windows：安装 Python 3.8–3.11 与 Visual Studio Build Tools（勾选“Desktop development with C++”）
- macOS：安装 Xcode 命令行工具（xcode-select --install）
- 全局工具与镜像：npm i -g yarn pm2 nodemon typescript；npm config set registry https://registry.npmmirror.com（国内加速）。
二 远程开发与多环境协同
- 使用 VS Code Remote-SSH 直连 CentOS 开发机，保持与服务器一致的 NVM/Node 环境；在远程终端中按项目切换 Node 版本（nvm use），VS Code 的终端与调试器均使用远程环境。
- 结合 Docker 在远程创建多套隔离的 Node 环境（不同版本/依赖），用容器编排开发、测试与 CI 流程，减少本机与远端环境差异带来的问题。
三 编写跨平台代码的要点
- 路径处理：始终使用 path.join / path.resolve，避免硬编码 “/” 或 “\”；用 path.sep 判断分隔符。
- 行尾与路径分隔符：Git 统一换行（core.autocrlf），脚本中避免依赖行尾差异。
- 环境变量：跨平台设置与读取使用 cross-env，避免 Windows set 与 Unix export 的差异。
- 子进程与命令：优先用 child_process.execFile / spawn 传数组参数，避免 shell 解析差异；必要时显式指定 shell: true 并控制工作目录。
- 文件监听：使用 chokidar 等跨平台库，处理 inotify/fs.watch 差异与网络盘场景。
- 平台判定：用 os.platform() / os.release() 做特性开关，避免用 process.platform 的字符串包含做复杂分支。
四 原生插件与构建链兼容
- 使用 node-gyp 构建原生模块：npm i -g node-gyp；在 CentOS 需提前装好 gcc/make/python3。
- 指定 Python：命令行 node-gyp configure --python /usr/bin/python3；或环境变量 npm_config_python（Windows 用 set）。
- 头文件镜像：下载 Node 头文件失败时使用 --dist-url https://npmmirror.com/mirrors/node。
- 常见故障排查：
- 找不到 Python：export NODE_GYP_FORCE_PYTHON=/usr/bin/python3
- Windows VS 版本：node-gyp configure --msvs_version=2022
- 与现有 Makefile 集成：用 binding.gyp 的 conditions/actions 调用 make 目标，既保留既有构建逻辑，又获得跨平台生成能力（VS/Xcode/Makefile 统一维护）。
五 一致的开发与交付流程
- 版本与依赖：用 .nvmrc / package.json engines 固定 Node 与包版本；在 CentOS 上用 NVM 安装与切换；必要时用 Docker 固化运行时。
- 本地/远端一致：本地也用 NVM；通过 Remote-SSH 在远端运行与调试，减少“在我机器上能跑”的问题。
- 任务编排：用 npm scripts / Makefile / just 统一命令；跨平台脚本前加 cross-env，必要时用 rimraf 替代 rm -rf。
- 调试与运行：VS Code 远程调试（launch.json）；服务用 PM2 守护与集群：pm2 start app.js --name “myapp”；pm2 startup；pm2 save。
- 网络与发布：云上实例需放行端口（如 3000/TCP），并在安全组与系统防火墙同步开放；用 curl 验证外部可达性。