This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

了解在 Expo 和 React Native 项目中管理环境变量的非 EAS 方法。

使用 EAS 环境变量 是管理云构建和更新环境变量的推荐方式，但你仍然可以在本地或使用其他工具进行工作。

不使用 EAS 管理环境变量

如果你想不使用 EAS 来管理环境变量，可以使用 dotenv（基于 Node 的加载器）或 Doppler 之类会注入环境变量的服务。这些工具允许你创建一个 .env 文件，用于存储环境变量。

注意： 如果你不使用 EAS 管理环境变量，请避免将密钥提交到 .env 文件中。

环境变量如何加载

创建 .env 文件后，你需要确保该文件未被列入 .gitignore 或 .easignore 文件中。之后，EAS 命令如 eas build、eas update 等就可以读取它。

.env 文件会按照 标准 .env 文件 的解析规则加载，然后将代码中对 process.env.EXPO_PUBLIC_[VARIABLE_NAME] 的所有引用替换为 .env 文件中设置的相应值。出于安全考虑，node_modules 目录中的代码不受影响。

在 EAS Hosting 中使用 .env 文件

在 EAS Hosting 中使用 .env 文件时，前缀为 EXPO_PUBLIC_ 的环境变量在客户端代码和服务端代码中都可用。未加 EXPO_PUBLIC_ 前缀的变量仅在服务端代码中可用。

包含客户端和服务端环境变量的步骤 与使用 EAS 环境变量时相同。因此，在运行 npx expo export 命令之前，你需要确保本地 .env 文件包含正确的环境变量。