为何Mac终端中create-react-app命令无法正常运行？

以下是几种常见原因和对应的解决方法：

• 网络连接不稳定
  create-react-app需要从npm仓库下载大量依赖包，网络波动或访问受限会导致下载中断。
  解决办法：使用国内镜像源加速，执行完整的创建命令：

  npx create-react-app my-app --registry=https://registry.npmmirror.com
  

  或者先全局配置镜像：

  npm config set registry https://registry.npmmirror.com
  

  配置完成后再重新运行npx create-react-app my-app。

• npm/npx缓存损坏
  缓存文件损坏会导致依赖下载异常。
  解决办法：清理缓存并重新尝试：

  npm cache clean --force
  

  然后删除已生成的不完整项目文件夹，重新执行创建命令。

• Node.js版本不兼容
  create-react-app对Node.js版本有最低要求（通常需要v14.0.0及以上），版本过低或过高都可能引发问题。
  解决办法：用nvm管理Node版本（推荐）：

  1. 安装nvm：

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
     

  2. 安装并切换到LTS长期支持版本：

     nvm install --lts
     nvm use --lts
     

  完成后重新创建应用。

• 权限问题
  Mac终端若没有足够的文件写入权限，会导致依赖包无法正常安装。
  解决办法：不要用sudo执行create-react-app（会引发后续权限隐患），优先在用户目录下创建项目，比如先执行cd ~/Desktop切换到桌面，再运行创建命令。

• 命令格式错误
  注意正确的命令格式：

  • 正确的npx命令：npx create-react-app <你的项目名>（必须指定项目名）
  • 正确的npm init命令：npm init react-app <你的项目名>
    之前的npx create-react-app未指定项目名、init react-app格式错误，都会导致执行异常。

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