---
title: "下載與基礎導航"
description: "根據 Google 官方 Getting Started 文件梳理 Antigravity 下載入口、平臺要求、更新機制，以及 Editor 與 Agent Manager 的基礎切換方式。"
verifiedAt: "2026-05-06"
---

安裝 Antigravity 不難，真正容易出錯的是兩個地方：系統環境不滿足官方最低要求，或者裝完以後分不清 Editor 和 Agent Manager 的切換關係。Google 官方 Getting Started 文件很短，本篇把它補成一條可執行的第一步路徑。

> [!NOTE]
> **這一篇解決什麼問題**：確認你應該從哪裡下載、當前系統是否適合安裝、更新應該怎麼處理，以及第一次進入產品後如何在 Editor 和 Agent Manager 之間來回切換。

> [!TIP]
> **閱讀目標**：讀完本章，你應該能獨立完成官方下載安裝前檢查、第一次開啟測試 workspace，並用只讀 prompt 驗證基礎工作面。

## 1. 從官方下載入口開始

官方下載入口是：

```text
https://antigravity.google/download
```

不要從映象站、網盤包、第三方“漢化包”或別人轉發的安裝器開始。Antigravity 是本地開發工具，會接觸程式碼、終端和瀏覽器；安裝包來源必須乾淨。

安裝前先做三件事：

1. 確認作業系統滿足官方最低要求。
2. 關閉舊安裝器或舊版本殘留程序。
3. 準備一個乾淨測試 workspace，不要第一次就開啟生產倉。

> [!IMPORTANT]
> **不要把下載頁面上的即時資訊寫死**：版本號、安裝包名稱、可用平臺會更新。教程裡固定的是官方入口和判斷方法，不固定某一天的包名。

## 2. 官方平臺要求

官方 Getting Started 文件列出的可用平臺和最低要求如下。

| 平臺 | 官方要求 | 實操判斷 |
| --- | --- | --- |
| macOS | Apple 仍提供安全更新的 macOS 版本；通常是當前和前兩個版本；最低 macOS 12 Monterey；不支援 x86 | Apple Silicon Mac 優先；Intel Mac 不要預設假設可用 |
| Windows | Windows 10 64-bit | 確認系統是 64 位，並準備常規開發工具鏈 |
| Linux | glibc >= 2.28，glibcxx >= 3.4.25，例如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8 | 先查發行版和 glibc 版本，再裝 |

Linux 使用者可以先查：

```bash
ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'
```

如果你不確定機器是否滿足要求，不要直接用真實專案測試。先安裝到獨立環境，開啟空目錄，確認啟動、登入和基礎導航都正常。

## 3. 第一次安裝後的更新處理

官方文件說明：應用有可用更新時會提示使用者。也就是說，Antigravity 不是“裝完一個固定版本長期不動”的工具。

建議建立下面的更新習慣：

- 普通學習環境：跟隨自動更新。
- 生產專案環境：更新後先用測試 workspace 驗證。
- 錄課或寫教程時：標註驗證日期，不把 UI 截圖當永久事實。
- 需要停留舊版本時：後續去 Releases 頁面查舊版本，但預設不推薦長期固定舊版本。

> [!WARNING]
> AI 程式設計工具迭代很快。模型、許可權項、設定頁和 UI 位置都可能變。遇到教程截圖和本機不同，先以官方當前 UI 為準。

## 4. 先理解兩個入口：Editor 和 Agent Manager

Antigravity 有兩個第一天就會遇到的核心介面：

| 介面 | 你在這裡做什麼 |
| --- | --- |
| Editor | 開啟一個 workspace，讀寫程式碼、看檔案、用 Tab / Command / Agent |
| Agent Manager | 管理多個 workspace 和多個 agent 任務，檢視 conversation 與 artifacts |

官方 Getting Started 文件給出的基礎導航是：

- 從 Editor 頂部按鈕開啟 Agent Manager。
- 從 Editor 用快捷鍵 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）開啟 Agent Manager。
- 在 Agent Manager 中，從 workspace 下拉選單的 **Focus Editor** 開啟對應 Editor。
- 當聚焦某個 workspace 時，可以用 **Open Editor** 按鈕或 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）開啟 Editor。

教程要記的是邏輯：Editor 負責單 workspace 的程式碼現場，Agent Manager 負責跨 workspace 的任務管理。

```mermaid
flowchart LR
    Editor["Editor<br/>單個 workspace"] -->|Top bar / Cmd+E (Mac) · Ctrl+E (Win)| Manager["Agent Manager<br/>任務與 artifacts"]
    Manager -->|Focus Editor| Editor
    Manager -->|Open Editor| Editor

    style Editor fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Manager fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
```

<details>
<summary>深讀：為什麼第一次不要直接開啟生產倉</summary>

Antigravity 是本地 agentic development platform，它會圍繞 workspace、terminal、browser 和 artifacts 工作。第一次啟動時，你還不知道當前賬號、許可權、快捷鍵、更新狀態和 agent 預設行為是否符合預期。

用空測試目錄啟動，可以把變數壓到最小：只驗證安裝來源、系統相容、Editor 與 Agent Manager 導航、只讀 prompt 約束是否生效。確認這些基礎面正常後，再開啟真實專案會穩得多。
</details>

## 5. 第一次開啟應該怎麼走

第一次啟動後，不要馬上接真實專案。建議按這個順序：

1. 開啟一個空測試目錄。
2. 在 Editor 裡確認檔案區、終端區和 agent 面板都能顯示。
3. 用頂部按鈕或 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）開啟 Agent Manager。
4. 從 Agent Manager 裡找到當前 workspace。
5. 用 **Focus Editor** 或 **Open Editor** 回到 Editor。
6. 只讀讓 agent 解釋當前目錄，不允許改檔案。

第一條 prompt 可以這樣寫：

```text
请只读分析当前 workspace，不要创建、修改或删除任何文件。
请说明：
1. 你现在能看到哪些文件或目录。
2. 你判断这是一个什么项目。
3. 如果下一步要修改，应该先改哪个最小文件。
4. 你需要哪些权限才能继续。
```

這條 prompt 的目的不是得到多聰明的答案，而是確認 Antigravity 的基礎工作面正常：能讀 workspace、能響應限制、不會越權動檔案。

## 6. 用導航關係判斷任務應該放哪裡

分不清入口時，用下面的規則：

| 任務 | 更適合入口 |
| --- | --- |
| 改當前檔案、看 diff、處理區域性錯誤 | Editor |
| 同時管理多個儲存庫或多個 agent | Agent Manager |
| 追蹤一個長任務的計劃和產物 | Agent Manager |
| 看 browser screenshot、recording、walkthrough | Agent Manager 或相關 artifact |
| 手動審查程式碼細節 | Editor |

一句話：**寫程式碼回 Editor，看任務和證據回 Agent Manager。**

## 7. 安裝完成後的驗收清單

安裝不以“圖示能開啟”為結束，至少驗證下面幾項：

- 下載來自 `antigravity.google/download`。
- 當前系統滿足官方平臺要求。
- 應用能啟動並完成登入或進入可用狀態。
- 能開啟測試 workspace。
- 能從 Editor 切到 Agent Manager。
- 能從 Agent Manager 回到對應 Editor。
- 能完成一條只讀 prompt，且沒有修改檔案。

這些都透過後，再繼續學習 Agent、許可權、rules、skills、Browser Agent 和 artifacts。

## 本章自檢

完成本章後，用這 3 個問題檢查自己是否真正理解：

1. 為什麼安裝包必須來自 `antigravity.google/download`？
2. Editor 和 Agent Manager 之間應該怎樣來回切換？
3. 第一條只讀 prompt 要驗證哪些基礎能力？

透過標準：你能在不接觸生產倉的情況下完成下載安裝、基礎導航和只讀工作面驗證。

## 官方來源

- [Google Antigravity Getting Started](https://antigravity.google/docs/get-started) —— 官方安裝、平臺要求、更新和基礎導航說明。
- [Google Antigravity Download](https://antigravity.google/download) —— 官方下載入口，避免使用第三方安裝包。
- [Google Antigravity Releases](https://antigravity.google/releases) —— 官方舊版本和釋出資訊入口，用於核對版本變化。

## 接下來去哪

<Cards>
  <Card title="Antigravity 是什麼" description="如果還沒建立產品心智模型，先回到官方概覽。" href="/zh-Hant/docs/antigravity/official/00-getting-started/00-product-overview" />
  <Card title="第一次安全執行" description="安裝完成後，按只讀、小改、瀏覽器驗收的順序跑第一天閉環。" href="/zh-Hant/docs/antigravity/understanding/02-install-first-safe-run" />
</Cards>
