如何强制Expo每次启动时自动更新环境变量取值

算力阿峰

2026-8-29

问题根因

cross-env、export设置临时环境变量不生效的核心原因：inline-dotenv babel插件默认仅读取项目根目录下.env文件内的变量，不会主动读取shell注入的系统环境变量。
expo r -c全量清缓存耗时久，是因为该命令会清除所有Metro打包、依赖预构建缓存，其中90%以上缓存内容和环境变量无关，完全没必要全量清理。

高效解决方案（启动耗时<2s，自动更新IP）

步骤1：配置启动前自动更新IP的脚本

在package.json的scripts字段中添加对应环境的脚本，启动Expo前会自动获取当前本地IP，覆盖.env文件中旧的LOCAL_IP_ADDRESS值：

Mac/Linux 环境：

{
  "scripts": {
    "start": "echo LOCAL_IP_ADDRESS=$(ipconfig getifaddr en0 2>/dev/null || hostname -I | awk '{print $1}') > .env && expo start",
    "android": "echo LOCAL_IP_ADDRESS=$(ipconfig getifaddr en0 2>/dev/null || hostname -I | awk '{print $1}') > .env && expo start --android",
    "ios": "echo LOCAL_IP_ADDRESS=$(ipconfig getifaddr en0 2>/dev/null || hostname -I | awk '{print $1}') > .env && expo start --ios"
  }
}

Windows 环境（PowerShell）：

{
  "scripts": {
    "start": "(Get-NetIPAddress -AddressFamily IPv4 | Where-Object { $_.InterfaceAlias -notmatch 'Loopback' -and $_.PrefixOrigin -eq 'Dhcp' } | Select-Object -First 1).IPAddress | ForEach-Object { \"LOCAL_IP_ADDRESS=$_\" } | Out-File -Encoding utf8 .env; expo start"
  }
}

注意：Mac设备如果使用有线网络，将脚本中en0替换为en1即可正常获取IP；WSL2环境直接取hostname -I输出的第一个IP就是Windows主机的本地IP。

步骤2：调整babel配置关闭dotenv缓存

打开项目根目录的babel.config.js，给inline-dotenv插件添加配置，关闭文件读取缓存：

module.exports = function(api) {
  api.cache(true);
  return {
    presets: ['babel-preset-expo'],
    plugins: [
      ['inline-dotenv', {
        systemVar: true,
        unsafeCache: false
      }]
    ]
  };
};

配置项说明：

systemVar: true：允许插件读取系统级环境变量，后续如果需要临时注入变量不需要改.env
unsafeCache: false：每次babel转译时重新读取.env文件内容，不会缓存旧的变量值

步骤3：快速重载应用

IP更新后不需要执行全量清缓存命令，只需要在Expo启动的交互终端中按r键重载bundle即可，babel会自动读取.env中最新的IP值，重载耗时通常在1s以内。

SDK 49+ 版本简化方案

如果使用Expo SDK 49及以上版本，可以直接卸载inline-dotenv插件，使用官方内置的环境变量能力：

将代码中引用的LOCAL_IP_ADDRESS变量名改为EXPO_PUBLIC_LOCAL_IP_ADDRESS（官方要求客户端侧可读取的环境变量必须加EXPO_PUBLIC_前缀）
保留上述自动写入.env的启动脚本即可，不需要额外修改babel配置，官方内置能力会自动识别.env文件变动，无需手动清理缓存。

内容的提问来源于stack exchange，提问作者Mahmoud Mousa Hamad