在T3 Turbo项目中正确配置Expo环境变量的方法

环境变量配置问题分析

在使用T3 Turbo项目模板开发Expo应用时，开发者经常会遇到环境变量无法正确加载的问题。这个问题通常表现为在Expo应用中无法访问预期的环境变量值，即使这些变量已经在.env文件中正确定义。

问题根源

问题的核心在于Expo对环境变量命名的特殊要求。与常规的Node.js项目不同，Expo要求前端可访问的环境变量必须使用特定的前缀。很多开发者直接从其他项目迁移过来，沿用原有的环境变量命名习惯，导致变量无法被Expo正确识别。

解决方案

正确的环境变量前缀

在Expo应用中，要使环境变量在前端代码中可访问，必须使用EXPO_PUBLIC_作为前缀。例如：

EXPO_PUBLIC_API_URL=https://api.example.com
EXPO_PUBLIC_GOOGLE_MAPS_KEY=your_key_here

环境变量文件位置

虽然Expo会从项目根目录的.env文件加载环境变量，但最佳实践是将Expo专用的环境变量放在/apps/expo/.env文件中，这样可以更好地隔离不同应用的环境配置。

运行时环境变量

对于需要在运行时动态设置的环境变量（如NODE_ENV），需要通过启动命令显式传递：

NODE_ENV=production expo start

配置注意事项

1. 变量命名一致性：确保所有需要在前端访问的变量都使用EXPO_PUBLIC_前缀
2. 文件权限：检查.env文件是否有正确的读取权限
3. 缓存问题：修改环境变量后，有时需要清除Expo缓存（expo start -c）
4. 类型安全：在使用TypeScript时，记得更新环境变量类型定义

最佳实践建议

1. 为开发、测试和生产环境分别创建不同的.env文件（如.env.development、.env.production）
2. 在团队协作时，将.env.example文件纳入版本控制，但不包含实际的.env文件
3. 对于敏感信息，考虑使用Expo的Config插件或安全存储方案

通过遵循这些指导原则，开发者可以确保环境变量在T3 Turbo项目的Expo应用中正确加载和使用，避免常见的配置问题。