Alamofire 42k Star 的 Swift 网络请求库，写起来是真舒服

Alamofire: 42k Star 的 Swift 网络请求库，写起来是真舒服

Swift 做 iOS 开发，绕不开网络请求。系统自带的 URLSession 功能齐全，但用起来繁琐，每次发请求都要写一堆模板代码。Alamofire 就是为了解决这个问题而生的。

Alamofire 是一个用 Swift 编写的 HTTP 网络库，目前在 GitHub 上收获了 42,387 个 Star。它由 Alamofire Software Foundation 维护，从 2014 年开始发展至今，已经是 Swift 生态中最主流的网络层方案之一。

它做了什么

简单来说，Alamofire 把 URLSession 的底层能力封装成了一套链式调用的 API。发一个 GET 请求，核心代码只需要一行：

let response = await AF.request("https://httpbin.org/get").serializingDecodable(MyModel.self).response

对比原生 URLSession 的写法，代码量差距明显。而且这一行代码里已经包含了自动重试、缓存策略、响应校验等能力，不需要额外配置。

核心特性

Alamofire 的功能覆盖面比较全，列举几个常用的：

• 链式请求/响应方法：所有操作可以串成一条链，可读性好
• Swift Concurrency 支持：从 iOS 13、macOS 10.15 起就支持 async/await，不需要额外适配
• Combine 支持：可以用响应式的方式处理网络数据流
• URL/JSON 参数编码：自动处理参数序列化
• 文件上传/下载：支持 File、Data、Stream、MultipartFormData 等多种方式
• 请求动态适配与重试：通过 RequestInterceptor 实现自动重试和请求修改
• TLS 证书固定：支持证书和公钥 Pinning，提升安全性
• 网络状态监测：内置 Reachability 检测能力
• cURL 命令输出：调试时可以直接生成对应的 cURL 命令

平台兼容性

Alamofire 当前支持 Swift 6.0/6.1/6.2，覆盖的平台包括 iOS、macOS、tvOS、watchOS、visionOS、Linux、Windows 和 Android。

其中 Apple 平台是完整支持，经过充分测试。Linux、Windows 和 Android 可以编译通过，但因为底层 swift-corelibs-foundation 存在一些缺陷，部分功能不可用，比如证书固定、HTTP 认证、缓存控制、WebSocket 等。项目方建议在这些平台上遇到问题时向 Swift 官方提交 Bug 报告。

安装方式

支持四种安装方式，按优先级排列：

Swift Package Manager（推荐）

在 Package.swift 中添加依赖：

dependencies: [
    .package(url: "Alamofire.git", .upToNextMajor(from: "5.11.0"))
]

然后引用 Alamofire target 即可。

CocoaPods

pod 'Alamofire'

Carthage

github "Alamofire/Alamofire"

手动集成

把 Alamofire.xcodeproj 拖进项目的 Project Navigator，选择对应的 framework 即可。

生态扩展

Alamofire 本身只做核心网络功能。如果需要图片加载和缓存，有官方的 AlamofireImage 库；如果需要控制 iOS 状态栏的网络活动指示器，有 AlamofireNetworkActivityIndicator。这两个子库由同一个基金会维护，和 Alamofire 配合使用。

一些细节

Alamofire 这个名字来源于 Alamo Fire 花，是德克萨斯州州花蓝帽花的一个杂交品种。

项目采用 MIT 协议开源。官方文档在 Alamofire 的 GitHub Pages 上有完整版本，从基础用法到高级自定义都有覆盖。遇到问题可以在 Stack Overflow 上用 alamofire 标签提问，也可以在 Swift 官方论坛的 Related Projects 板块讨论。

对于 Swift 开发者来说，如果项目需要一个稳定、功能完整、社区活跃的网络库，Alamofire 是目前最主流的选择。42k Star 的背后是十年的持续维护和大量生产环境的验证。

开发者来说，如果项目需要一个稳定、功能完整、社区活跃的网络库，Alamofire 是目前最主流的选择。42k Star 的背后是十年的持续维护和大量生产环境的验证。