安装react-native并执行expo init命令报错如何解决？

1 先校验执行的命令合法性 #

你当前执行的expo init First project存在参数错误：项目名称包含空格且没有用引号包裹，属于非法输入。请先修改为以下任意一种正确命令：

• 无空格命名：expo init FirstProject
• 带空格命名（用引号包裹）：expo init "First project"

如果调整命令后依然报错，按以下步骤逐层排查：

2 基础环境校验 #

• 检查Node.js版本：Expo要求Node.js最低版本为18，执行node -v查看当前版本，版本过低直接升级到Node.js LTS稳定版即可
• 检查expo-cli安装状态：执行expo --version验证是否全局安装成功，无返回结果则先执行npm install -g expo-cli完成全局安装
• 检查包管理器镜像源：国内用户默认使用npm官方源大概率会出现网络超时问题，执行npm config get registry查看当前源，可切换为国内镜像源提升拉取成功率
• 检查当前目录权限：确保你执行命令的目录没有读写限制，不要在系统级目录（比如Windows的C盘根目录、Mac的/System目录）下初始化项目

3 常见报错场景处理 #

3.1 网络超时/模板拉取失败 #

• 先清空npm缓存：执行npm cache clean --force后重新执行初始化命令
• 可添加参数跳过完整性校验：expo init FirstProject --skip-integrity-check

3.2 权限报错（提示permission denied） #

• Windows用户：右键点击VSCode选择「以管理员身份运行」后重新执行命令
• Mac/Linux用户：在命令前加sudo提权执行，或者修改npm全局包安装目录避免长期权限问题

3.3 依赖安装中途失败 #

• 执行带跳过依赖安装参数的初始化命令：expo init FirstProject --no-install
• 初始化完成后手动进入项目目录，执行npm install完成依赖安装

3.4 端口占用报错 #

• 执行命令释放Expo默认占用端口：npx kill-port 19000 19001 19002后重新初始化

4 兜底解决措施 #

如果以上步骤都无法解决问题，按顺序执行以下操作：

• 卸载重装全局expo-cli：npm uninstall -g expo-cli && npm install -g expo-cli
• 重启VSCode确保环境变量生效，或更换其他终端工具（比如系统自带的cmd/terminal）执行初始化命令
• 更换本地存储目录重新执行初始化操作，排除目录权限问题

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