在WSL中创建React应用失败，但Windows系统可正常运行

排查与修复步骤 #

• 检查Node.js和npm版本
  在WSL终端执行：

  node -v
  npm -v
  

  确保Node.js版本在14.x及以上，npm版本与Node.js匹配。如果版本过低，推荐用nvm（Node版本管理器）更新：

  1. 执行nvm官方提供的安装脚本获取工具
  2. 重启终端后安装并切换到最新LTS版本：

  nvm install --lts
  nvm use --lts
  

• 清理npm缓存
  缓存损坏可能导致包拉取失败，执行：

  npm cache clean --force
  

• 切换到WSL原生目录执行命令
  不要在/mnt/c、/mnt/d等Windows挂载磁盘目录下运行命令，切换到WSL自己的家目录（执行cd ~）后再运行npx create-react-app。Windows文件系统的权限和性能限制会干扰npm工具正常运行。

• 手动指定create-react-app版本
  尝试指定最新版本拉取项目：

  npx create-react-app@latest my-app
  

• 修复npm全局权限
  如果出现权限报错，不要用sudo执行npm命令，而是修复npm全局目录权限：

  mkdir -p ~/.npm-global
  npm config set prefix '~/.npm-global'
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc
  

• 检查网络连接
  如果是网络问题导致无法拉取npm包，确认WSL能正常访问外网，必要时配置npm代理（替换为你的代理地址）：

  npm config set proxy http://your-proxy-address:port
  npm config set https-proxy http://your-proxy-address:port
  

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