已安装Node.js的离线环境下创建React应用的条件及npm报错解决

触发的ENOTFOUND报错本质是npm执行create-react-app命令时，需要从公共npm源拉取脚手架包，因当前无网络无法解析registry.npmjs.org域名、无法完成远程请求导致的常规网络类报错，和代码配置、本地环境本身无关。

所需满足的核心条件 #

• 本地安装的Node.js、npm版本，与预先准备离线依赖的有网环境版本完全匹配，避免原生依赖的二进制兼容问题
• 脚手架本身、React运行时依赖、构建工具链（webpack、babel、react-scripts等）的所有包文件提前以离线形式存储在本地
• 提前将npm配置为离线运行模式，关闭联网校验、远程包拉取逻辑，避免执行命令时自动向公网发请求

可落地的离线操作方案 #

• 提前在有网环境将create-react-app脚手架打包为本地tar包，连同项目依赖的全量tarball存入本地npm缓存目录，执行创建命令时直接指定使用本地包路径完成初始化
• 初始化完成后的项目启动、构建操作，全部调用本地node_modules目录下的可执行文件，不触发远程包下载逻辑，即可完成离线运行
• 可搭配无需联网的本地静态托管服务提前托管所有依赖包，配置npm源指向本地地址，就能在离线环境正常执行常规npm操作

这种方式完全可以正常运行，但需要满足几个硬性要求，否则会触发联网请求或运行报错：

• 拷贝时需要将有网环境下已经安装完成的node_modules目录完整复制到离线项目文件夹中，不能仅拷贝源码、配置文件，否则离线环境无法执行npm install拉取缺失依赖
• 两台设备的操作系统（Windows/macOS/Linux）、Node.js大版本必须完全一致：node_modules中包含大量和平台绑定的原生二进制依赖，跨平台、跨Node版本的包无法直接运行
• 拷贝完成后需要提前执行npm config set offline true开启离线模式，避免npm自动校验包完整性、触发联网请求，启动项目时直接调用node_modules/.bin/react-scripts start即可正常启动开发服务，也可直接执行node_modules/.bin/react-scripts build完成离线生产构建
• 不要在拷贝后的项目中修改package.json的依赖版本、新增依赖，否则npm会自动识别依赖缺失触发联网下载逻辑

内容的提问来源于stack exchange，提问作者Saidur Rahman