Mac端Android Studio运行React Native项目报错求助

问题背景 #

我们用React Native开发应用，Mac端开发者近一周半无法通过Android Studio模拟器启动项目，报错：No identifiers allowed directly after numeric literal。团队Windows成员无此问题，且该Mac开发者已尝试以下方案仍未解决：

• 检查代码中是否存在以数字开头的变量，未发现
• iOS模拟器（Xcode）可正常运行项目
• 删除并重新安装项目
• 切换至Git中两个月前可正常运行的版本
• 删除node_modules后重新执行npm install
• Android Studio中执行“Sync project with gradle files”
• Android Studio运行简单项目正常
• 删除所有模拟器后重新创建
• 卸载并重新安装Android Studio

针对性解决方案 #

结合Mac环境特性及问题排他性，尝试以下步骤：

1. 统一Node.js版本 #

团队Windows成员使用的Node版本需和Mac端保持一致，建议用nvm管理版本：

# 安装对应版本（替换为团队使用的版本号，比如18.17.0）
nvm install 18.17.0
# 切换到该版本
nvm use 18.17.0
# 重新安装依赖
rm -rf node_modules package-lock.json
npm install

之后重新启动项目测试。

2. 清理Gradle全局缓存 #

Mac端Gradle缓存可能存在损坏，执行以下操作：

# 删除全局Gradle缓存
rm -rf ~/.gradle/caches
# 进入项目Android目录清理项目缓存
cd android
./gradlew clean

回到项目根目录重新启动模拟器。

3. 验证Android SDK环境变量配置 #

检查Mac端~/.zshrc（或~/.bash_profile，根据你使用的Shell）中的Android环境变量是否正确：

export ANDROID_HOME=$HOME/Library/Android/sdk
export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

执行source ~/.zshrc使配置生效，重启终端和Android Studio后重试。

4. 统一JDK版本 #

React Native要求JDK 11（部分版本兼容17），确认Mac端JDK版本与团队一致：

# 查看当前JDK版本
java -version

若版本不符，可通过jenv或官方JDK安装包切换至对应版本，再重新构建项目。

5. 禁用Rosetta翻译（M系列芯片Mac） #

若使用的是M1/M2/M3芯片，检查Android Studio是否通过Rosetta运行：

• 右键Android Studio图标 → 显示简介
• 取消勾选“使用Rosetta打开”
• 重启Android Studio后重新启动模拟器

6. 对齐gradle.properties配置 #

对比团队Windows端项目的android/gradle.properties文件，确保Mac端配置完全一致，尤其是org.gradle.jvmargs、kotlin_version等关键参数，避免因Mac特定配置导致语法解析错误。

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