React Native切换环境变量需清理Xcode构建文件夹的问题与解决

切换环境后变量不更新的核心原因是Metro或Xcode缓存了旧的环境变量值，以下是具体解决步骤：

1. 确保Babel插件动态读取对应.env文件 #

如果使用babel-plugin-inline-dotenv处理环境变量，在babel.config.js中配置动态路径，避免缓存固定文件的变量：

module.exports = {
  presets: ['module:metro-react-native-babel-preset'],
  plugins: [
    ['inline-dotenv', {
      path: `./.env.${process.env.NODE_ENV || 'development'}`,
      allowUndefined: false
    }]
  ]
};

注意NODE_ENV的值要和你的Scheme/环境完全匹配（比如staging环境对应NODE_ENV=staging）。

2. 给Xcode Scheme添加预构建清理脚本 #

让Xcode每次构建前自动清理缓存并注入正确环境变量：

• 打开Xcode，选中目标Scheme → 点击Edit Scheme → 切换到Build标签 → 点击Pre-actions
• 添加新的Run Script Action，粘贴以下脚本：

# 清理Metro缓存
rm -rf "$PROJECT_DIR/../node_modules/.cache/metro"
rm -rf "$PROJECT_DIR/../.metro-health-check"

# 清理当前项目的Xcode派生数据缓存
rm -rf ~/Library/Developer/Xcode/DerivedData/$(basename "$PROJECT_DIR")-*

# 绑定当前Configuration到NODE_ENV（自动转小写匹配.env后缀）
export NODE_ENV=${CONFIGURATION,,}

# 若使用react-native-config，强制重新生成配置
npx react-native-config

3. 配置package.json脚本，强制跳过缓存 #

在package.json的scripts中添加带缓存清理的启动/构建命令，确保每次启动加载新变量：

"scripts": {
  "start:dev": "NODE_ENV=development npx react-native start --reset-cache",
  "start:staging": "NODE_ENV=staging npx react-native start --reset-cache",
  "start:prod": "NODE_ENV=production npx react-native start --reset-cache",
  "ios:dev": "NODE_ENV=development npx react-native run-ios --scheme development --configuration Debug",
  "ios:staging": "NODE_ENV=staging npx react-native run-ios --scheme staging --configuration Release",
  "ios:prod": "NODE_ENV=production npx react-native run-ios --scheme production --configuration Release"
}

重点是--reset-cache参数，强制Metro不使用旧缓存资源。

4. 调整Xcode构建设置减少缓存干扰 #

如果上述步骤未解决问题，可调整Xcode构建配置：

• 打开Xcode → File → Project Settings → Build Location，将Build System改为Legacy Build System（新构建系统的缓存机制可能导致变量不更新）
• 在Scheme的Build选项中，取消勾选Parallelize Build和Find Implicit Dependencies，减少缓存依赖链。

5. 验证环境变量是否生效 #

在代码中添加日志验证，确保切换环境后变量正确更新：

console.log('当前环境:', process.env.NODE_ENV);
console.log('API地址:', process.env.API_URL);

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