开发Node.js扩展时node-gyp应设为devDependency还是dependency？

1. 依赖类型选择（devDependency / dependency） #

具体要根据你发布的Node.js扩展包的分发形式决定：

• 如果你会提前预编译所有主流平台/Node版本对应的扩展二进制文件，用户安装时无需本地编译：node-gyp 应该添加到 devDependency。这种场景下只有你开发、打包预编译产物时才会用到该工具，用户侧不需要调用。
• 如果你不提供预编译二进制，要求用户安装包时在本地实时编译扩展：node-gyp 应该添加到 dependency，保证用户安装时能调用到该工具完成编译流程。

行业通用实践 #

目前绝大多数Node.js扩展包都会选择预编译二进制的分发方案，配合prebuild-install等工具实现用户安装时自动拉取对应架构的二进制产物，无需本地编译。这种模式下统一将node-gyp放在devDependency即可，仅适配极小众平台、或协议要求必须源码分发的场景才会将其放到生产依赖。

2. npm 内置情况说明 #

npm 从v3版本开始就内置了对应版本的node-gyp，正常情况下不需要用户全局安装该工具。
需要注意的是，node-gyp运行依赖本地编译环境：Windows下需要Visual Studio构建工具+Python，macOS需要Xcode命令行工具，Linux需要gcc/g++、make工具链，这类环境需要用户自行提前配置。

内容的提问来源于stack exchange，提问作者Rami Sabbagh