React项目执行npm install安装依赖失败无法本地启动问题求助

你遇到的报错核心为grpc依赖包安装异常，可按以下步骤依次尝试解决：

• 配置国内镜像源解决二进制包拉取失败问题，依次执行以下全局配置命令：

npm config set registry https://registry.npmmirror.com
npm config set disturl https://npmmirror.com/dist
npm config set grpc_binary_host_mirror https://npmmirror.com/mirrors/grpc-node/

配置完成后删除项目根目录下的node_modules文件夹、package-lock.json文件，重新执行npm install即可。

• 若上述操作后仍报错，说明本地缺少grpc编译所需的基础工具链，按操作系统安装对应依赖：
  • Windows系统：执行npm install -g windows-build-tools安装编译依赖，完成后重启终端重试
  • macOS系统：执行xcode-select --install安装Xcode命令行工具后重试
  • Linux（Debian/Ubuntu系）系统：执行sudo apt install build-essential python3安装编译工具链后重试
• 若仍未解决，检查Node版本兼容性：grpc@1.24.x及更早版本不支持Node 16及以上版本，可使用nvm切换到Node 14 LTS版本后重新执行安装操作。
• 若依赖安装完成后站点无法启动，优先排查两类常见问题：项目启动所需的环境变量是否配置完整、启动端口是否被其他进程占用。

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