2、开发环境搭建：Node.js与npm安装、C/C++编译器配置（Windows/Linux/macOS）、node-gyp工具详解
说实话，很多同学刚开始接触原生模块开发时，第一道坎往往不是代码本身，而是环境搭建。我见过太多人卡在编译这一步，报错信息看得一头雾水。今天咱们就把这事彻底捋清楚。
2.1 Node.js 与 npm 安装
Node.js 是咱们开发的基础，npm 是包管理工具。这两兄弟缺一不可。
安装方式其实很简单：
- 去官网下载 LTS 版本（我个人习惯用 LTS，稳定第一）
- Windows 下直接双击 .msi 安装包，一路 Next
- macOS 下可以用 .pkg 安装包，或者用 Homebrew：
brew install node - Linux 下建议用 nvm 管理版本，避免权限问题
node -v 和 npm -v，确认版本号正常。如果 npm 版本太旧，可以用 npm install -g npm@latest 升级。
这里有个坑要注意——不要用 sudo 装全局包。我在项目中遇到过权限冲突导致模块加载失败的情况，后来改用 nvm 就再没出过问题。
2.2 C/C++ 编译器配置
原生模块需要编译 C/C++ 代码，所以编译器是必须的。不同系统差别还挺大，咱们一个一个说。
Windows 环境
Windows 下最推荐的是 Visual Studio Build Tools。别装完整的 VS，太重了。只需要装 Build Tools 就行。
- 下载
vs_BuildTools.exe，安装时勾选「C++ 生成工具」 - 或者用
npm install --global windows-build-tools（不过这个方案现在有点过时了） - 我个人的经验：直接装 VS 2022 Community 版，只选 C++ 工作负载，省心
macOS 环境
macOS 下需要安装 Xcode Command Line Tools。打开终端，跑一行命令：
xcode-select --install它会弹窗提示安装，点确认就行。装完后可以用 gcc --version 验证。
嗯，这里要注意：如果你装了完整版 Xcode，记得先打开一次，同意许可证。不然编译时会报错。
Linux 环境
Linux 下最方便，用包管理器装 gcc 和 g++ 即可：
# Ubuntu/Debian
sudo apt-get install build-essential
# CentOS/RHEL
sudo yum groupinstall "Development Tools"
# Fedora
sudo dnf groupinstall "Development Tools"装完后检查一下：gcc --version 和 g++ --version。我建议 gcc 版本不低于 8.x，太老的版本对 C++11/14 支持不好。
2.3 node-gyp 工具详解
node-gyp 是原生模块编译的核心工具。说白了，它就是个胶水层——把 Node.js 和 C/C++ 编译器连接起来。
安装方式：
npm install -g node-gyp装完后，核心命令就这几个：
| 命令 | 作用 | 使用场景 |
|---|---|---|
node-gyp configure |
生成构建配置文件 | 首次编译或修改 binding.gyp 后 |
node-gyp build |
执行编译 | 日常开发中反复使用 |
node-gyp rebuild |
清理 + 配置 + 编译 | 最常用，一步到位 |
node-gyp clean |
清理构建产物 | 遇到奇怪错误时试试 |
node-gyp configure。我刚开始时经常忘记这步，编译出来的 .node 文件还是旧的，排查了半天才发现。
binding.gyp 文件长什么样？ 给你看个最简单的例子：
{
"targets": [
{
"target_name": "hello",
"sources": [ "src/hello.cc" ],
"include_dirs": [ "include" ],
"libraries": []
}
]
}这个文件告诉 node-gyp：我要编译一个叫 hello 的模块，源码在 src/hello.cc，头文件在 include 目录下。
2.4 常见问题与避坑指南
环境搭建这块，我踩过的坑比走过的路还多。挑几个典型的说说：
- Python 版本问题： node-gyp 依赖 Python 2.7 或 3.x（3.7+）。我曾经装了 Python 3.11，结果 node-gyp 报错说找不到。后来发现需要设置
npm config set python python3 - 权限问题： Linux/macOS 下全局安装 node-gyp 时，记得用
sudo。但编译项目时不要用 sudo，否则生成的文件权限会乱 - 缓存问题： 如果编译失败，先跑
node-gyp clean再重试。有时候缓存文件损坏了，不清掉就会一直报错
--verbose 参数能看到详细日志。比如 node-gyp rebuild --verbose。这样能定位到具体是哪个文件、哪行代码出了问题。
最后说一句：环境搭建这事，一次配好，后面就顺了。别怕报错，每个错误信息都在告诉你问题在哪。我刚开始时也经常被各种编译错误搞到崩溃，但慢慢就摸出门道了。
下一章咱们开始写第一个原生模块，到时候这些配置就派上用场了。