Swift 一行代码换模型，怎么用

苹果平台的开发者常卡在一个两难里：用系统自带模型，简单但没得选；接多个推理服务，灵活但要写好几套代码。

Hugging Face 给出的答案是 AnyLanguageModel 1.0，10 月 20 日发布，去年 11 月首次亮相。一句话概括它想解决的：一套代码，通吃本地和云端。

一、发生了什么

据 Hugging Face 博客介绍，AnyLanguageModel 是苹果 Foundation Models 框架的即插即用替代品。开发者只要把 import 语句从 FoundationModels 换成 AnyLanguageModel，同一套会话代码就能跑在系统模型、llama.cpp 和 MLX 等本地引擎，以及一堆云端服务上。

同时发布的还有 swift-huggingface 和 swift-xet 两个包，负责把模型下载从 Hub 加速拉进 Swift 应用。

这一年里补上的能力包括：工具调用、引导生成在所有后端通用；图像支持；推理过程进会话记录；切换服务商时自动去掉对方不能重放的推理块；API 密钥改由闭包提供，方便用短时效 token。它还能跑在 Linux 上，服务端可以复用同一套逻辑。

从一行 import 起步，到今天覆盖工具调用、图像、多后端，这个包在一整年里把自己补得越来越完整。

二、跟你有什么关系

如果你在做苹果平台的 AI 应用：一套代码同时覆盖本地和云端，省掉为每个服务商单独接一遍的功夫。接一个服务商是一遍，接五个就是五遍，现在一遍搞定。

如果你想让应用离线也能跑：可以先用 llama.cpp 或 MLX 跑本地小模型，需要更强能力时切到云端，不用改核心代码。离线能跑，在线能更强，切换只在参数之间。

如果你在选模型：官方给了几个起点，Gemma 4 E2B 和 LFM2.5 2.6B 约 3.4GB 和 1.7GB，能装进手机；更大的 Qwen3.8 27B 约 16GB，得 32GB 内存以上的 Mac。模型大小直接决定你能在什么设备上跑。

如果你做服务端：它能跑在 Linux 上，服务端可以复用同一套会话逻辑。客户端和服务端用一套代码，维护成本会低不少。

三、怎么用

1. 引入依赖，把 import FoundationModels 换成 import AnyLanguageModel，先让现有代码跑起来。先把替换这一步走通，再谈其他。
2. 按场景选后端：轻量任务走本地模型，重任务接托管服务，用同一个会话接口切换。本地管隐私和离线，云端管能力，各干各的。
3. 升级已有项目前，先读官方的迁移说明，别指望所有老代码都是只改一行。迁移文档写在那，先读再动手。

四、三个别信的说法

只改一行 import 就能完成所有迁移。 错。官方也引导老项目去看迁移文档，部分项目要改的不止一行。一行 import 是入口，不是全部。

本地模型和云端服务表现完全一致。 错。公告没有提供基准或性能数据，跨后端的一致性目前是厂商自己的说法，别当第三方评测看。一致性是承诺，不是已经证明的结果。

什么规模的模型都能塞进手机。 错。几 GB 的小模型可以，几十 GB 的大模型要么上大内存 Mac，要么走云端。手机内存摆在那，装不下就是装不下。

五、一句话结论

一行代码换模型，换来的是本地和云端的自由切换，但迁移前先读文档。

信息来源

• AnyLanguageModel 1.0: One Year of Local Models on Apple Platforms（Hugging Face 博客，2026-10-20）
• Hugging Face Releases AnyLanguageModel 1.0 for Swift Apps（AI Breaking Wire）

功能与价格以官方公告为准。本文写于 2026 年 10 月 21 日。