执行npm install -g expo-cli安装Expo CLI出现大量警告如何解决？

问题背景 #

执行全局安装命令 npm install -g expo-cli 时弹出大量警告提示。

常见产生原因 #

• Node.js 版本不符合 Expo CLI 适配要求：Expo CLI 仅对特定范围的 Node.js LTS 版本做了兼容适配，版本过高或过低都会触发依赖校验警告
• npm 版本的依赖校验规则差异：npm v7及以上版本会严格校验 peerDependencies 依赖匹配度，Expo CLI 依赖链较长，极易触发依赖版本不匹配的非阻断性警告
• npm 全局目录写入权限不足：Windows/Mac/Linux 系统下如果当前用户对npm全局安装目录没有足够写入权限，会触发文件写入类警告
• 本地npm缓存损坏：历史缓存的依赖包版本存在冲突，拉取依赖时的版本 mismatch 会触发警告

对应解决方法 #

• 版本适配校验：优先使用 Expo 官方推荐的 Node.js LTS 版本（当前推荐v18、v20大版本），执行 node -v 可查看当前版本，版本不符建议通过nvm、nvm-windows等版本管理工具切换到兼容版本
• 修复全局安装权限
  • Mac/Linux系统：无需使用sudo执行安装，执行以下命令修改npm全局目录到当前用户目录下，避免权限问题：

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

    如果使用的是bash终端，将.zshrc替换为.bashrc即可
  • Windows系统：右键点击终端图标，选择「以管理员身份运行」后再执行安装命令
• 清除缓存重装：执行以下命令清空npm本地缓存后重新安装：

  npm cache clean --force
  npm install -g expo-cli
  

• 非阻断性警告可直接忽略：安装完成后执行 expo --version，如果可以正常输出版本号，说明Expo CLI已经安装成功，单纯的peerDependencies匹配警告属于依赖链上游的版本标注问题，不会影响正常功能使用，无需额外修复
• 备选安装方案：如果npm安装始终报错，可使用yarn完成全局安装：

  yarn global add expo-cli
  

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