---
title: "llama.cpp 踏入 1.0.0　以主版本號明確標示 API 不相容"
url: https://sammy.hk/llama-cpp-v1-release/
author: Ethan
published: 2026-11-16T10:53:00+08:00
modified: 2026-11-16T10:05:46+08:00
description: "llama.cpp 團隊於 2026 年 11 月 13 日宣佈，llama.cpp 與其張量函式庫 ggml 同步發布 1.0.0，這是專案自 2023 年創始以來約三年半首個主版本號。團隊表明今後兩個專案都會以主版本號反映 API 與 ABI 的不相容改動，讓下游開發用戶能清晰判斷升級風險。[1][2][3] 由溝…"
categories: ["開放源碼"]
tags: [ggml, llama.cpp, "本地AI", "開源專案"]
source: https://sammy.hk
---
![llama.cpp 1.0.0 語義化版本 API 穩定性](https://sammy.hk/wp-content/uploads/2026/11/openrouter_google_gemini-3_1-flash-lite-image_20261116_100106_1bcae4d0.jpg)llama.cpp 團隊於 2026 年 11 月 13 日宣佈，`llama.cpp` 與其張量函式庫 `ggml` 同步發布 1.0.0，這是專案自 2023 年創始以來約三年半首個主版本號。團隊表明今後兩個專案都會以主版本號反映 API 與 ABI 的不相容改動，讓下游開發用戶能清晰判斷升級風險。\[1\]\[2\]\[3\]

## 由溝動更新走向語義化版本

llama.cpp 以量化、後端最佳化與可攜的 C/C++ 實作，令多模態大型語言模型可以在由消費級機器到高階伺服器的各種硬件之上跑。專案過去以高頻提交與溝動式發布為主，隨著下游用戶增加，介面釘定性成為實際問題。團隊指出，每一個新的整合都意味著更多開發者依賴其函式庫介面，因此「嚴性但釘定」的 API 至關重要，1.0.0 正是對這些開發者的承諾擔負。\[1\]

依官方公開的語義化版本規則，`./include` 內公開 C API 出現不相容改動時升主版本；向後相容的功能、後端更新、新模型支援或新增 API 升次版本；瑕疵修正升修訂版本。這套規則同時用於所有採用語義化版本的 ggml-org 專案\[1\]。

## API 與 ABI 界界清晰

配合新版本，官方列出各函式庫對應的公開標頭：`libllama` 對應 `llama.cpp/include/`，`libggml` 對應 `ggml/include/`。過去開發者要自行判斷哪些標頭屬於釘定介面，現在界界以目錄形式明示，羈條件保護者亦可據此判斷何時需要同步升級\[1\]\[2\]\[3\]。

對下游打包者而言，另一項實用資訊是發布渠道清單。官方現時提供 Linux、macOS、Windows、Android 及 iOS 的預先建置產物，並透過 Docker、Debian、Homebrew、conda-forge、MacPorts、Winget 及 XCFramework 分發，其他打包討論串供打包與發布流程整合參考\[1\]。

## 後端與模型覆蓋持續擴充

基於 `ggml` 的後端架構，llama.cpp 可把不同硬件後端編譯成獨立動態函式庫，在執行時按需載入；官方籌目前支援超過 150 種模型架構變體，以及主流推理解碼方法（speculative decoding）\[1\]。

團隊亦把資源投放在持續整合。借助 HF Buckets 與 HF Jobs，專案可為每次合併至 master 的改動提供足夠運算容量跑測試、驗證正確性；硬件支援來自 NVIDIA、AMD、Qualcomm、Arm、IBM 及 Intel，自建 runner 覆蓋主要平台。官方同時提到，在 AI 輔助編程式日益普及之下，堅持高品質程式、掌握架構與理解實作細節仍是首要原則\[1\]。

## 升級前要留意的重點

對直接連結 `libllama` 或 `libggml` 的專案，1.0.0 本身並未宣告具體的 API 破壞，但版本號規則的改變意味著日後主版本升級必須當作不相容處理：重新編譯、檢查標頭變更，並確認 ABI 相容性，而非假設小數版本就一定安全\[1\]。

使用發布渠道如 Homebrew 等通道的用戶，須留意各渠道跟隨 1.0.0 的時間可能不一；如果同時使用 `llama.app` 桌面應用或自行編譯，宜統一版本，以免函式庫與前端介面錯配。官方表明會持續推出大發布方式，並歡迎打包者回報整合問題\[1\]

## 參考資料

\[1\] [llama.cpp v1.0.0: A stronger foundation for the local AI ecosystem（2026-11-13）](https://huggingface.co/blog/ggml-org/llama-cpp-v1)

\[2\] [llama.cpp v1.0.0 Release（2026-11-13）](https://github.com/ggml-org/llama.cpp/releases/tag/v1.0.0)

\[3\] [ggml v1.0.0 Release（2026-11-13）](https://github.com/ggml-org/ggml/releases/tag/v1.0.0)

### 相關文章：

1. [llama.cpp 與 ggml 同步發布 1.0.0 以語意化版本界定介面](https://sammy.hk/llama-cpp-1-0-release/ "llama.cpp 與 ggml 同步發布 1.0.0 以語意化版本界定介面")
2. [PrismML 將 27B 推理模型壓到 5.9GB：可以放入電腦甚至手機](https://sammy.hk/prismml-%e5%b0%87-27b-%e6%8e%a8%e7%90%86%e6%a8%a1%e5%9e%8b%e5%a3%93%e5%88%b0-5-9gb%ef%bc%9a%e5%8f%af%e4%bb%a5%e6%94%be%e5%85%a5%e9%9b%bb%e8%85%a6%e7%94%9a%e8%87%b3%e6%89%8b%e6%a9%9f/ "PrismML 將 27B 推理模型壓到 5.9GB：可以放入電腦甚至手機")
3. [NVIDIA RTX Spark 手提電腦正式開賣 單機可跑前沿 AI 模型](https://sammy.hk/nvidia-rtx-spark-%e6%89%8b%e6%8f%90%e9%9b%bb%e8%85%a6%e6%ad%a3%e5%bc%8f%e9%96%8b%e8%b3%a3-%e5%96%ae%e6%a9%9f%e5%8f%af%e8%b7%91%e5%89%8d%e6%b2%bf-ai-%e6%a8%a1%e5%9e%8b/ "NVIDIA RTX Spark 手提電腦正式開賣 單機可跑前沿 AI 模型")
4. [開源核心模組解鎖 Ada 顯示卡限制 專案公開可重現測試數據](https://sammy.hk/ada-gpu-tensor-unlock-linux/ "開源核心模組解鎖 Ada 顯示卡限制 專案公開可重現測試數據")
