SwiftConfig: 在Swift中管理应用程序配置

SwiftConfig 是一个轻量级的 Swift 库（适用于 iOS/macOS），旨在集中管理应用程序设置。它允许从 JSON、YAML 或 plist 文件加载、解析和访问配置数据，并支持环境变量。该库对于需要无需重新编译即可灵活调整应用行为的项目尤其有用（例如，在测试/生产服务器之间切换）。

为什么需要 SwiftConfig？

在标准的 iOS/macOS 开发中，通常使用 UserDefaults、Info.plist 或硬编码的常量。这会导致一些问题：

代码与配置混合
缺乏类型化（所有值都是字符串）
环境切换困难

SwiftConfig 通过提供强类型化的 API 并支持多个数据源解决了这些问题。

安装

通过 Swift Package Manager 在 Xcode 中添加 SwiftConfig：

// Package.swift 或通过 Xcode 菜单：File > Add Packages....package(url: "https://github.com/example/SwiftConfig", from: "1.0.0")

或者通过 CocoaPods：

pod 'SwiftConfig', '~> 1.0'

主要功能

格式支持： JSON, YAML, plist, .env
类型化访问： 自动转换为 Int、Bool、URL、Date
层级键： 通过点号访问嵌套字段（例如 "database.host"）
环境变量： 环境变量优先级高于文件设置
缓存： 一次性加载，并可选择强制刷新

代码示例

import SwiftConfig

// 定义配置结构struct AppConfig: Codable {    let apiURL: URL    let timeout: Double    let features: [String: Bool]}

// 从 config.json 文件加载let config = try SwiftConfig.load(    from: "config",          // 不含扩展名的文件名    type: .json,    as: AppConfig.self)

// 使用print(config.apiURL)         // https://api.example.comprint(config.timeout)        // 30.0print(config.features["darkMode"]) // true

// 无需解码直接访问嵌套字段let host: String = try SwiftConfig.value(for: "database.host")print(host) // localhost