---
title: "Release notes"
description: "Gemini CLI release notes：stable、preview、nightly 三個渠道，以及如何根據風險選擇版本。"
verifiedAt: "2026-05-09"
---

Gemini CLI 更新很快。看 release notes 的目的不是追新，而是判斷你當前教程、工作流和指令碼有沒有被版本變化影響。

> [!IMPORTANT]
> 教程、自動化指令碼和 CI 不應預設跟 nightly。除非文章明確寫“實驗能力”，否則以 stable 為基準，並記錄驗證日期。

## 三個渠道

```text
stable   推荐给普通用户和生产工作流
preview  给愿意提前反馈新功能的用户
nightly  每日构建，风险最高
```

安裝命令：

```bash
npm install -g @google/gemini-cli@latest
npm install -g @google/gemini-cli@preview
npm install -g @google/gemini-cli@nightly
```

## 官方釋出節奏

官方 release 文件描述了 stable、preview、nightly 的晉級流程。大體上，main 分支的新變化先進入 nightly，再進入 preview，最後晉級 stable。

官方文件還描述了每週釋出節奏：新的 stable 和 preview 通常按周釋出，nightly 每天從 main 釋出。穩定釋出會經過 promotion；patch 會針對 stable / preview 按需修復。

## 渠道選擇表

| 使用場景 | 推薦渠道 | 需要記錄 |
| --- | --- | --- |
| 新手教程、公開課程、團隊 SOP | stable / `latest` | CLI 版本、驗證日期、認證方式 |
| 預覽即將上線的能力 | preview | 具體版本、回退方式、差異說明 |
| 復現 main 分支新 bug 或新功能 | nightly | 安裝時間、npm 版本、是否可回 stable |
| CI / GitHub Action | stable，必要時 pin 版本 | workflow 輸入、許可權、失敗日誌 |
| 截圖教程 | stable + 固定驗證日期 | UI 是否隨版本變化 |

## 看 release notes 的順序

1. 先看當前安裝版本：`gemini --version`。
2. 再看 npm dist-tag：`latest`、`preview`、`nightly`。
3. 對比 changelog latest 和 preview。
4. 如果教程依賴實驗功能，記錄具體版本和驗證日期。
5. 如果自動化指令碼失敗，先查是否有 CLI 引數、輸出格式、approval mode 或工具名變更。

NPM dist-tag 是版本渠道判斷的關鍵來源。遇到“我明明裝了 preview/nightly，但行為像 stable”的情況，先查 npm 當前 tag、`command -v gemini` 和安裝來源，再判斷是不是 PATH 或包管理器混用。

## 教程維護建議

Gemini CLI 欄目要定期檢查這些變化：

- 新命令。
- 配置欄位變更。
- 模型預設值變更。
- sandbox 和許可權策略變化。
- hooks、skills、subagents 這類 agent 能力變化。
- GitHub Action 輸入、許可權和 secret 變化。

推薦把 release 複檢拆成三類：

| 變化型別 | 需要檢查的頁面 |
| --- | --- |
| 新命令 / 引數 | CLI reference、commands、quickstart |
| 許可權 / sandbox / policy | security、tools、automation |
| 模型 / quota / 認證 | authentication、quota、models、privacy |
| GitHub Action | automation、issue / PR automation |
| 包結構 / 安裝 | installation、uninstall、npm package |

## 不建議

不要把 nightly 行為寫成穩定教程。可以寫“實驗能力”，但要標清版本和驗證日期。

## 驗收方式

教程更新前用 stable 復跑核心路徑，再用 preview 檢查即將變化的 UI 和命令。只要發現命令、配置欄位、預設模型、許可權提示發生變化，就把對應頁面標記為需複核，而不是隻改一處截圖。

## 下一步

<Cards>
  <Card title="NPM package" description="版本和釋出問題繼續看 package 結構和 workspace 邊界。" href="/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/84-npm-package" />
  <Card title="Release channels" description="普通讀者如何選擇 stable / preview / nightly，回看釋出渠道頁。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/05-release-channels" />
  <Card title="GitHub Action" description="CI 自動化受版本影響時，回看 GitHub Action 配置。" href="/zh-Hant/docs/gemini-cli/official/07-integrations-automation/74-github-action" />
</Cards>

## 官方來源

- [Gemini CLI releases](https://github.com/google-gemini/gemini-cli/blob/main/docs/releases.md)
- [Gemini CLI releases documentation](https://google-gemini.github.io/gemini-cli/docs/releases.html)
- [Gemini CLI changelog latest](https://github.com/google-gemini/gemini-cli/blob/main/docs/changelogs/latest.md)
- [Gemini CLI changelog preview](https://github.com/google-gemini/gemini-cli/blob/main/docs/changelogs/preview.md)
