Swift中如何优雅实现URL查询参数的自定义排序

要实现按固定顺序组合必选/可选参数且保持代码简洁易维护，核心思路是把预定义的参数顺序、参数名、值的获取逻辑集中到一个配置数组里，通过遍历这个数组生成最终的queryItems。

步骤1：定义参数顺序与值处理逻辑 #

先创建一个数组，按你需要的顺序（urlQuery、searchText、name、age、filterTerm、gender、nextOfKin）存放每个参数的名称和值的提供逻辑：

// 辅助函数：过滤空字符串的可选值
func nonEmptyValue(_ value: String?) -> String? {
    guard let value = value, !value.isEmpty else { return nil }
    return value
}

// 按预定义顺序排列的参数配置
let parameterConfig: [(name: String, valueProvider: () -> String?)] = [
    ("url", { nonEmptyValue(urlQuery) }),
    ("text", { nonEmptyValue(searchText) }),
    ("name", { name }), // 必选参数直接返回值
    ("age", { age }),
    ("filter", { nonEmptyValue(filterTerm) }),
    ("gender", { gender }),
    ("nextOfKin", { nextOfKin })
]

步骤2：生成QueryItems数组 #

遍历配置数组，自动过滤掉空的可选参数，生成符合顺序的queryItems：

let queryItems = parameterConfig.compactMap { config in
    guard let value = config.valueProvider() else { return nil }
    return URLQueryItem(name: config.name, value: value)
}

// 直接赋值给URLComponents
component?.queryItems = queryItems

方案优势 #

• 维护成本极低：调整参数顺序只需修改parameterConfig数组的元素位置，新增/删除参数只需在数组中增减元素
• 逻辑集中：必选/可选参数的处理逻辑统一在一处，避免分散的if判断导致代码混乱
• 可读性强：参数顺序一目了然，无需跟踪多处append或赋值代码

替代优化（如果需要复用逻辑） #

如果多个API都需要类似的参数顺序管理，可以把参数配置和生成逻辑封装到URLComponents的扩展中：

extension URLComponents {
    mutating func setQueryItems(with parameterConfig: [(name: String, valueProvider: () -> String?)]) {
        let queryItems = parameterConfig.compactMap { config in
            guard let value = config.valueProvider() else { return nil }
            return URLQueryItem(name: config.name, value: value)
        }
        self.queryItems = queryItems
    }
}

// 使用方式
component?.setQueryItems(with: parameterConfig)

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