安裝 Cloud Code for IntelliJ 外掛程式

注意： 我們已將工具整合至名為 Antigravity 的單一多代理平台，Antigravity CLI 現已推出。自 2026 年 6 月 18 日起，Gemini Code Assist IDE 擴充功能和 Gemini CLI 將停止為個人版 Gemini Code Assist、Google AI Pro 和 Google AI Ultra 方案提供要求服務。受影響的使用者應遷移至 Antigravity 和 Antigravity CLI。詳情請參閱淘汰項目頁面。

Cloud Code for IntelliJ 外掛程式為 JetBrains 系列 IDE 增加了對 Google Cloud 開發的支持，包括 IntelliJ（社群版和旗艦版）、GoLand、PyCharm、WebStorm（以及其他）。

必要條件

注意： 您必須使用 JetBrains IDE 2022.3 以上版本，才能使用 Cloud Code for IntelliJ。

以下工具需要安裝並設定在您的系統上，並且可在您機器的 PATH 上使用：

• JetBrains IDE 2022.3 以上版本

  您的 IDE 必須是以下其中一種 JetBrains IDE：

  • IntelliJ Ultimate 或 Community
  • PyCharm Professional 或 Community
  • WebStorm
  • GoLand

• Git 以便 Cloud Code 可以執行 Git 操作，例如複製樣本。

• Docker 用於建置和推送容器映像。

• 已設定的 Kubernetes 叢集可以是本機開發作業使用的叢集 (例如 minikube 或 Docker Kubernetes 叢集)，也可以是遠端叢集 (例如 Google Kubernetes Engine 叢集)。建議您使用 minikube 叢集進行本機開發作業；minikube 可由 Cloud Code 自動管理。

• Google Cloud 專案，並啟用計費功能 (如果您使用 Google Cloud)。專案可讓您在一個地方收集單一應用程式的所有相關資源，以及管理 API、啟用 Google Cloud服務、新增和刪除協作者以及管理Google Cloud 資源的權限。

安裝 Cloud Code 插件

從 JetBrains Marketplace 安裝 Cloud Code 外掛程式。

注意： 安裝 Cloud Code 時，系統預設也會安裝 Gemini Code Assist 外掛程式。

或者，您也可以直接從 IDE 安裝插件：

1. 啟動 IDE。

2. 打開 IDE 的插件市集：

   • 在 Windows 上，依序前往「File」 >「Settings」 >「Plugins」。
   • 如果是 macOS，請依序前往「IntelliJ IDEA」 >「Preferences」 >「Plugins」。

3. 在搜尋欄位中輸入 Google Cloud Code，然後安裝 Cloud Code 外掛程式。

   

4. 如果出現提示，請重新啟動 IDE 以啟動外掛程式。

5. 如果您使用 Android Studio 做為 IDE，請在安裝 Cloud Code 後停用 Google Cloud Tools for Android Studio 外掛程式，以免發生任何衝突。「Tools for Android Studio」 Google Cloud 外掛程式即將淘汰，並會在日後的 Android Studio 版本中完全移除。

受管理依附元件

根據預設，Cloud Code 會自動安裝部分必要的指令列依附元件，例如：

• kubectl用於操作 Kubernetes 叢集和管理 Kubernetes 部署。
• skaffold 支援 Kubernetes 叢集上的持續開發作業、建構及標記智慧型映像檔，以及一系列受到支援的部署和建構類型。
• minikube，以支援本機開發作業。
• gcloud CLI，支援管理 Google Cloud上的資源。

依附元件的自訂版本

如要使用自訂版本的依附元件，請按照下列步驟停用依附元件管理功能：

1. 確認您已安裝自訂版本的依附元件：

   • kubectl
   • Skafold
   • minikube 用於本地開發
   • 使用 Google Cloud開發時的 Google Cloud CLI

2. 在 IDE 中依序開啟「File」 >「Settings」 >「Tools」 >「Cloud Code」 >「Dependencies」，指定相關的 Cloud Code 設定。如果是 Mac OS X，請依序開啟「IntelliJ IDEA」 >「Preferences」 >「Tools」 >「Cloud Code」 >「Dependencies」。

3. 若要管理 gcloud CLI，請在 Cloud SDK 部分中選擇 使用自訂本機安裝，點擊欄位旁的 瀏覽 資料夾圖標，導覽至要使用的 gcloud CLI 安裝，然後點擊 確定。

4. 如要管理其他依附元件，請在「Deployment Tools」部分選取「Use custom specified dependencies」，然後按一下每個依附元件的「Browse」資料夾圖示，為每個依附元件指定要使用的自訂版本路徑，然後按一下「OK」。

選用：下載並驗證 Cloud Code 二進位檔

驗證 Cloud Code 二進位檔案有助於確保 Cloud Code 外掛程式在發布和交付流程中沒有被篡改。

若要將 Cloud Code Stable 或 Insiders 二進位檔案下載到您的計算機，請依照下列步驟操作：

1. 在 Cloud Code 的「外掛程式版本」頁面中，選取「穩定版」或「搶先體驗版」管道。

   有關 Insiders 版本的更多信息，請參閱 使用預發布功能。

2. 下載最新版 Cloud Code，或下載您要驗證的版本 (該版本必須屬於目前支援驗證的版本)：

   • 穩定版：23.1.1-221/23.1.1-222 (不含 23.1.1-221/23.1.1-222) 之後的所有版本

   • 搶先體驗版：23.1.1-221-IB.1/23.1.1-222-IB.1 之後的每個版本 (不含 23.1.1-221-IB.1/23.1.1-222-IB.1)

3. 請記下 Cloud Code 二進位檔的路徑 (google-cloud-code.zip 檔案)。

若要驗證 Cloud Code 二進位檔，請依照下列步驟操作：

1. 將最新版的 marketplace-zip-signer-cli.jar 檔案下載至電腦。記下你的 jar 檔案的路徑。

2. 下載「DigiCert Trusted Root G4」。 記下憑證檔案的路徑。

   提示： 由於「DigiCert 信任的根授權單位憑證」頁面上的項目眾多，請使用 Ctrl/Cmd+F 搜尋 DigiCert Trusted Root G4。

3. 確認已安裝 JDK。這是執行 Java 命令所必需的。

4. 如要驗證 zip 檔案 (Cloud Code 二進位檔)，請在指令列中執行下列指令：

   java -jar PATH_TO_ZIP_SIGNER_JAR verify -in PATH_TO_ZIP_FILE -cert PATH_TO_CERTIFICATE_FILE
   

   如果驗證失敗，指令列輸出內容會顯示下列其中一則訊息：

   • Zip archive is not signed by provided certificate authority.
   • Provided zip archive is not signed.
   • Signature of zip archive is invalid.

   如果指令列輸出內容中沒有顯示任何訊息，代表驗證成功。

取得支援

如要在 IntelliJ IDE 中提供意見回饋或回報問題，請依序前往「工具」 >「Cloud Code」 >「說明 / 關於」 >「提交意見回饋或回報問題」，在 GitHub 上回報問題。