iOS Swift应用全局/环境变量存储 有无类似.env文件的最佳实践？

原生内置方案（无第三方依赖，官方推荐） #

• Xcode Build Configuration + 自定义构建设置
  这是苹果官方推荐的标准多环境配置方案，步骤如下：

  1. 在Xcode项目的「Info」标签下的「Configurations」分区，点击+号新增Staging配置，选择复制Release配置即可。
  2. 进入Build Settings页面，点击左上角+号选择「Add User-Defined Setting」，自定义变量名比如API_BASE_URL，分别给dev（对应Debug配置）、staging、production（对应Release配置）填写对应的接口地址。
  3. 在项目的Info.plist文件中新增键APIBaseURL，值填$(API_BASE_URL)，编译时Xcode会自动根据当前选择的构建配置替换为对应的值。
  4. Swift代码中统一读取配置：

  enum APIConfig {
      static let baseURL: String = {
          guard let url = Bundle.main.object(forInfoDictionaryKey: "APIBaseURL") as? String else {
              fatalError("Base URL 未在Info.plist中配置")
          }
          return url
      }()
  }
  

  切换环境只需要修改运行Scheme对应的Build Configuration即可，还可以同步给不同配置设置不同的Bundle ID、App图标，避免测试时混淆生产包和测试包。

• 编译Flag + Swift 常量枚举
  如果不需要外部修改配置，也可以通过编译标记直接在代码中区分环境：

  1. 在Build Settings的「Other Swift Flags」配置项中，给Debug配置加-D DEBUG、Staging配置加-D STAGING标记。
  2. 代码中直接根据编译标记返回对应配置：

  enum APIConfig {
      #if DEBUG
      static let baseURL = "https://dev.example.com/api"
      #elseif STAGING
      static let baseURL = "https://staging.example.com/api"
      #else
      static let baseURL = "https://prod.example.com/api"
      #endif
  }
  

  该方案不需要读取plist，运行性能更高，缺点是修改配置需要改动代码，不适合配置项频繁变更的场景。

类.env第三方方案 #

如果你习惯Web端的.env工作流，Swift生态也有对应的成熟实现：

• 可以创建.env.dev、.env.staging、.env.prod三个配置文件，将其加入.gitignore避免敏感配置提交到代码仓库。
• 常用工具包括CocoaPods Keys、dotenv.swift、XcodeGen，都可以配置为编译期自动读取对应环境的.env文件，将配置值注入到Info.plist或自动生成Swift常量代码，和原生方案的使用方式一致。
  注意：不要直接将.env文件打包进入App包，会导致敏感配置直接泄露，必须通过工具在编译期注入值，打包时排除.env源文件。

选型建议 #

• 中小型项目、配置项少的场景优先选择原生Build Configuration方案，无额外依赖，稳定性最高。
• 团队多人协作、配置项多的场景可以选择.env类方案，方便统一管理配置，避免本地修改冲突。
• 所有配置统一封装到独立的配置层，不要硬编码在业务代码中，后续修改只需要调整配置层即可，不需要改动业务逻辑。

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