與 Gemini Code Assist Standard 和 Enterprise 版對話

本文說明如何使用 Gemini Code Assist (IDE 中的 AI 輔助協作工具),在 VS Code 或 IntelliJ 和其他支援的 JetBrains IDE 中執行下列操作:

  • 取得指引,協助解決程式碼問題。
  • 為專案產生程式碼。
  • 指定檔案和資料夾,管理專案的內容。
  • 建立自訂指令和規則。

如果您使用 Gemini Code Assist Enterprise,可以透過程式碼自訂功能,直接從 Gemini Code Assist Enterprise 取得貴機構私人程式碼集的程式碼建議。瞭解如何設定程式碼自訂功能

本文件適用於各種程度的開發人員。本文假設您已具備 VS Code 或 IntelliJ,以及其他支援的 JetBrains IDE 的實用知識,並熟悉 Google Cloud。您也可以在 Cloud Shell 編輯器Cloud WorkstationsAndroid Studio 中探索 Gemini Code Assist。

事前準備

VS Code

  1. 設定 Gemini Code Assist Standard 版或 Enterprise 版 (如果尚未設定)。

  2. 在程式碼檔案中測試 Gemini Code Assist 功能前,請確認檔案的程式設計語言是否受到支援。如要進一步瞭解支援的程式語言,請參閱「支援的程式語言」。

  3. 如果您偏好在 Proxy 後方使用 IDE,請參閱「Visual Studio Code 中的網路連線」。

IntelliJ

  1. 設定 Gemini Code Assist Standard 版或 Enterprise 版 (如果尚未設定)。

  2. 在程式碼檔案中測試 Gemini Code Assist 功能前,請確認檔案的程式設計語言是否受到支援。如要進一步瞭解支援的程式語言,請參閱「支援的程式語言」。

  3. 如要在 Proxy 後方使用 IDE,請參閱「HTTP Proxy」。

使用 Gemini Code Assist 對話說明程式碼

在本節中,您會提示 Gemini Code Assist 解釋現有程式碼。

VS Code

如要取得程式碼說明,請按照下列步驟操作:

  1. 開啟程式碼檔案。

  2. 在 IDE 的活動列中,按一下 spark「Gemini Code Assist」

  3. 在「Gemini Code Assist」窗格中輸入提示 Explain this code to me,然後點按「傳送」send

    Gemini Code Assist 會將程式碼檔案中的程式碼做為提示的參考內容,並回覆程式碼的說明。

    如要參照特定程式碼區塊,而非檔案中的所有程式碼,請在程式碼檔案中選取該區塊,然後提示 Gemini Code Assist。

IntelliJ

如要取得程式碼說明,請按照下列步驟操作:

  1. 在 IDE 中開啟程式碼檔案。

  2. 在 Gemini Code Assist 工具視窗中輸入提示詞 Explain this code to me,然後按一下「提交」

Gemini Code Assist 會將程式碼檔案中的程式碼做為提示的參考內容,並回覆程式碼的說明。

如果只想瞭解程式碼的特定部分,可以選取特定程式碼,然後再次提示 Gemini Code Assist。Gemini Code Assist 只會將選取的程式碼做為參考,生成回覆內容。

Gemini Code Assist 在回覆中提供程式碼時,您可以在回覆結尾選取下列選項:

  • 在游標位置插入:將生成的程式碼插入目前檔案的游標位置。

  • 在新檔案中插入:開啟新檔案,並將產生的程式碼插入新檔案。

    Gemini 會在生成程式碼回覆的結尾列出程式碼動作。

當 Gemini Code Assist 識別出程式碼區塊使用的語言,且目前 IDE 支援該語言時,就會顯示這些選項。

查看查詢記錄

如要重複使用先前的提示,請點按「Gemini Code Assist」工具視窗中的 schedule「Show Query History」,在「Query History」中尋找。

工具視窗中的 Gemini 查詢記錄。

建立多個對話

您可以建立多個 Gemini Code Assist 對話,每個對話都有自己的內容,與其他對話無關。對話記錄會顯示你第一次對話的時間和最後更新時間戳記。最多只能有 20 個對話。 達到上限後,新增對話時,系統會自動刪除最舊的對話。

VS Code

  1. 如要新增對話,請按一下「新增」「新對話」,然後在文字欄位中輸入提示。輸入提示後,Gemini Code Assist 會建立新的對話。
  2. 如要存取先前的對話,請按一下「記錄」繼續先前的對話。系統會顯示對話清單。選取要查看的對話。
  3. 如要刪除對話串,請按一下「繼續先前的對話」,然後按一下要刪除的對話旁的「刪除」

IntelliJ

  1. 如要新增對話,請按一下「新增」「新對話」,然後在文字欄位中輸入提示。輸入提示後,Gemini Code Assist 會建立新的對話。
  2. 如要存取先前的對話,請按一下「chat_bubble」chat_bubble「近期對話」。畫面隨即會顯示對話清單。選取要查看的對話。
  3. 如要刪除對話串,請依序點選「近期對話」和要刪除的對話旁邊的「刪除」

清除對話記錄

Gemini Code Assist 會使用對話記錄,在回覆提示時提供額外背景資訊。如果對話記錄不再相關,可以清除對話記錄

管理即時通訊

如要管理 Gemini Code Assist 的對話設定,請按照下列步驟操作:

設定自動捲動

VS Code

根據預設,Gemini Code Assist 會自動捲動對話。如要停用這項行為,請執行下列工作:

  1. 依序前往「設定」>「擴充功能」>「Gemini Code Assist」

  2. 搜尋「自動捲動」設定,然後取消勾選核取方塊。

IntelliJ

這項功能不支援 IntelliJ 和其他 JetBrains IDE 的 Gemini Code Assist。

停止進行中的即時通訊

VS Code

如要停止生成回覆,請按一下「停止」

停止 VS Code Gemini Code Assist 對話回覆的按鈕

IntelliJ

如要停止生成回覆,請按一下「停止」

停止 IntelliJ Gemini Code Assist 對話回覆的按鈕

選取模型

如果您使用 Gemini Code Assist 標準版或企業版, 或是訂閱 Google AI Pro 或 Ultra 方案,可以選取 Gemini Code Assist 處理提示時使用的模型。

VS Code

  1. 在 Gemini Code Assist 對話窗格中,按一下模型選取器下拉式選單。

  2. 選取要讓 Gemini Code Assist 使用的模型。

IntelliJ

這項功能不支援 IntelliJ 和其他 JetBrains IDE 的 Gemini Code Assist。

編輯先前的提示

編輯先前的提示時,Gemini Code Assist 會根據編輯後的提示重新生成回覆。如要編輯提示,請按照下列步驟操作:

VS Code

  1. 在對話窗格中,將指標懸停在要編輯的提示上。

  2. 按一下「編輯」

    在 VS Code Gemini Code Assist 中修改提示。

  3. 修改提示,然後按一下「更新」

    Gemini Code Assist 會根據編輯後的提示生成新回覆。

IntelliJ

  1. 在對話窗格中,將指標懸停在要編輯的提示上。

  2. 按一下「編輯」

    在 IntelliJ Gemini Code Assist 中修改提示。

  3. 修改提示,然後按一下「更新」

    Gemini Code Assist 會根據編輯後的提示生成新回覆。

重新生成提示回覆

如要重新生成對最新提示的回覆,請按照下列步驟操作:

VS Code

在 Gemini Code Assist Chat 窗格中,按一下最新回覆底部的「重新播放」「重新生成回覆」

Gemini Code Assist 會重新評估您最近的提示,並提供新的回覆。

IntelliJ

在 Gemini Code Assist Chat 窗格中,按一下最新回覆底部的「重新播放」「重新生成回覆」

Gemini Code Assist 會重新評估您最近的提示,並提供新的回覆。

刪除提示和回覆配對

如要刪除提示和 Gemini Code Assist 對該提示的回覆,請按照下列步驟操作:

VS Code

  1. 在對話窗格中,將指標懸停在要移除的提示上。

  2. 按一下「Delete」(刪除)

    在 VS Code Gemini Code Assist 中刪除提示和回覆配對。

  3. 系統提示確認是否要刪除提示和回覆配對時,請選取「刪除」。否則請按一下「取消」取消作業。

    系統會從與 Gemini Code Assist 的對話記錄中,移除提示和回覆。

IntelliJ

  1. 在對話窗格中,將指標懸停在要移除的提示上。

  2. 按一下「Delete」(刪除)

    在 IntelliJ Gemini Code Assist 中刪除提示和回覆配對。

  3. 系統提示確認是否要刪除提示和回覆配對時,請選取「刪除」。否則請按一下「取消」取消作業。

    系統會從與 Gemini Code Assist 的對話記錄中,移除提示和回覆。

設定程式碼預覽窗格

根據預設,系統會啟用 Gemini Code Assist 對話的程式碼預覽窗格設定。啟用這項設定後,Gemini Code Assist 對話中的預覽程式碼區塊會顯示前 6 行程式碼。你可以展開及收合程式碼區塊。

如要變更預設設定,請執行下列工作:

VS Code

  1. 在 IDE 中,依序前往「設定」>「擴充功能」 >「Gemini Code Assist」

  2. 搜尋「Default Code Block Display」設定。

  3. 選取下列選項之一:

    • 展開:自動展開 Gemini Code Assist 對話回覆中的所有程式碼區塊。

    • 預覽:只會顯示程式碼區塊中的前 6 行程式碼。您必須展開 Gemini Code Assist 對話回覆中的程式碼區塊,才能查看其餘程式碼。這是預設設定。

    • 收合:自動收合 Gemini Code Assist 對話回覆中的所有程式碼區塊。

    IDE 重新載入後,新設定就會生效。

IntelliJ

這項功能是 IntelliJ Gemini Code Assist 和其他 JetBrains IDE 的預設功能,無法設定。

使用即時通訊功能,透過選取的程式碼提示 Gemini Code Assist

Gemini Code Assist 可以根據您選取的程式碼執行工作或回答問題。如要根據提示和所選程式碼取得生成的程式碼,請按照下列步驟操作:

VS Code

  1. 在活動列中,按一下 spark「Gemini Code Assist」,開啟「Gemini Code Assist」窗格。

  2. 在程式碼檔案中,選取程式碼區塊。

  3. Gemini Code Assist 窗格的文字欄位中,輸入所選程式碼的提示。

    舉例來說,選取程式碼中的函式,然後輸入提示 Write a unit test for this function

    Gemini 會以您選取的程式碼做為參考,並回覆提示。

IntelliJ

  1. 在活動列中,按一下「spark」「Gemini Code Assist」,開啟「Gemini Code Assist」工具視窗。

  2. 在程式碼檔案中,選取程式碼區塊。

  3. Gemini Code Assist 工具視窗的文字欄位中,輸入所選程式碼的提示。

    舉例來說,選取程式碼中的函式,然後輸入提示 Write a unit test for this function.

    Gemini Code Assist 會以選取的程式碼做為參考,並回應提示。

將選取的程式碼片段新增至脈絡

您可以選取、附加程式碼片段,並指示 Gemini Code Assist 著重處理這些片段。選取程式碼片段後,即可針對較小的程式碼區塊進行個別分析,不必分析整個檔案。

在程式碼檔案中選取程式碼片段後,您可以指示 Gemini Code Assist 將程式碼片段新增至內容抽屜

在編輯器視窗中選取但尚未新增至「內容匣」的任何項目,也會自動納入內容。所選程式碼片段只會顯示在單一對話回合中。這些建議不會保留在「內容抽屜」中,但會保留在 Gemini Code Assist 對話記錄中。

在本節中,您會將選取的程式碼片段新增至環境,並請 Gemini Code Assist 說明該片段:

VS Code

  1. 在程式碼檔案中選取程式碼片段。

  2. 在 Gemini Code Assist Chat 文字欄位中,按一下「新增至對話情境」

    Gemini Code Assist 會將選取的程式碼片段新增至「內容抽屜」。

  3. 在 Gemini Code Assist Chat 文字欄位中,輸入提示詞 what does this code do?

    Gemini Code Assist 會根據「內容」抽屜中選取的程式碼片段,回覆您的提示。

IntelliJ

  1. 在程式碼檔案中選取程式碼片段。

  2. 選取 spark Gemini 圖示,然後從選單中選取「將所選文字新增至對話內容」

    程式碼片段會新增至內容抽屜。

使用對話功能,透過選取的終端機輸出內容提示 Gemini Code Assist

Gemini Code Assist 可根據所選終端機輸出內容執行工作或回答問題。如要請 Gemini 說明所選終端機輸出內容,請按照下列步驟操作:

VS Code

  1. 在 IDE 中開啟終端機 (依序點選「View」>「Terminal」)。

  2. 選取任何終端機輸出內容。

  3. 在選取的終端機輸出內容上按一下滑鼠右鍵,然後選取「Gemini Code Assist: Add to Chat Context」

    Gemini Code Assist 會將終端機輸出內容新增至「內容」抽屜。

  4. 在 Gemini Code Assist Chat 文字欄位中,輸入提示詞 what does this do?

    Gemini Code Assist 會根據「內容抽屜」中選取的終端機輸出內容,回覆你的提示。

IntelliJ

  1. 在 Gemini Code Assist Chat 文字欄位中,輸入 @terminal

  2. 在隨即顯示的清單中,選取「終端機」下方的終端機,即可查詢相關資訊。

    在 IntelliJ 中選取終端機。

  3. 在 Gemini Code Assist Chat 文字欄位中,輸入提示詞 what does this do?

    Gemini Code Assist 會根據所選終端機輸出內容,回覆你的提示。

在工作區環境中指定檔案和資料夾

您可以指定工作區中的檔案或資料夾,供 Gemini Code Assist 做為背景資訊。指定資料夾時,Gemini Code Assist 會將資料夾中的檔案和子資料夾中的檔案做為脈絡。

VS Code

如要在對話提示中指定檔案或資料夾,請輸入「@」,然後選取要指定的檔案或資料夾。

指定 VS Code 應瞭解本機程式碼集的檔案和資料夾。

如要瞭解程式碼集內兩個檔案的差異,請按照下列步驟操作:

  1. 在活動列中,按一下 spark「Gemini Code Assist」

  2. Gemini Code Assist 窗格中輸入提示 Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2,然後按下 Enter 鍵 (Windows 和 Linux) 或 Return 鍵 (macOS),或 Tab 鍵。你也可以點選清單中的檔案名稱來選取檔案。按一下檔案名稱,即可將檔案新增至提示內容,並在 IDE 中開啟檔案。

Gemini Code Assist 會根據您指定的兩個檔案提供背景資訊,並回覆提示。Gemini Code Assist 也會納入您在「Context Sources」(內容來源) 中指定的檔案。

指定這些檔案後,您可以在同一則對話記錄中繼續提出其他問題或提示,不必再次指定檔案。

舉例來說,在 Gemini Code Assist 窗格中輸入提示詞 How can I improve YOUR_FILE_NAME_1? (不含 @ 符號),然後按下 Enter 鍵 (Windows 和 Linux) 或 Return 鍵 (macOS)。

Gemini Code Assist 會回覆您在提示中指定的檔案相關查詢。

IntelliJ

如要在對話提示中指定檔案或資料夾,請輸入「@」,然後選取要指定的檔案或資料夾。

指定 IntelliJ 應瞭解本機程式碼集的檔案。

如要瞭解程式碼集內兩個檔案的差異,請按照下列步驟操作:

  1. 在活動列中,按一下 spark「Gemini Code Assist」

  2. Gemini Code Assist 窗格中輸入提示 Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2,然後按下 Enter 鍵 (Windows 和 Linux) 或 Return 鍵 (macOS),或 Tab 鍵。你也可以點選清單中的檔案名稱來選取檔案。按一下檔案名稱,即可將檔案新增至提示內容,並在 IDE 中開啟檔案。

Gemini Code Assist 會根據您指定的兩個檔案提供背景資訊,並回覆提示。Gemini Code Assist 也會納入您在「Context Sources」(內容來源) 中指定的檔案。

指定這些檔案後,您可以在同一則對話記錄中繼續提出其他問題或提示,不必再次指定檔案。

舉例來說,在 Gemini Code Assist 窗格中輸入提示詞 How can I improve YOUR_FILE_NAME_1? (不含 @ 符號),然後按下 Enter 鍵 (Windows 和 Linux) 或 Return 鍵 (macOS)。

Gemini Code Assist 會回覆您在提示中指定的檔案相關查詢。

在內容抽屜中管理檔案和資料夾

指定要用做 Gemini Code Assist 提示詞情境的檔案或資料夾後,這些檔案和資料夾會放在「情境抽屜」中,您可以在這裡查看及從提示詞情境中移除檔案和資料夾。

如要管理「內容匣」中的檔案和資料夾,請執行下列工作:

VS Code

  1. 在 IDE 的活動列中,按一下 spark「Gemini Code Assist」

  2. 如要查看內容抽屜中的檔案和資料夾,請按一下「內容項目」

    Gemini Code Assist for VS Code 的內容匣

  3. 如要從內容匣中移除項目,請按一下「移除」close

IntelliJ

  1. 在活動列中,按一下 spark「Gemini Code Assist」

  2. 如要查看內容抽屜中的檔案和資料夾,請按一下「內容」

    Gemini Code Assist for IntelliJ 的內容匣

  3. 如要從內容匣中移除檔案和資料夾,請按一下「移除」close

從本機環境排除檔案

如果 .aiexclude.gitignore 檔案中指定了檔案,Gemini Code Assist 預設會將這些檔案從程式碼自動完成、程式碼生成、程式碼轉換和對話的本機使用情境中排除。

如要瞭解如何排除不想使用的本機檔案,請參閱「排除不想使用的檔案」一文。

還原即時通訊中的檢查點

套用 Gemini Code Assist 根據提示生成的變更後,您可以選擇將修改後的程式碼檔案還原至特定檢查點,這會將所有套用的變更還原至程式碼檔案。

還原至檢查點不會還原您可能對程式碼檔案所做的手動變更。

如要將程式碼檔案還原至檢查點,請按照下列步驟操作:

VS Code

在 Gemini Code Assist 對話窗格中,按一下「undo」「Revert to checkpoint」。這會將程式碼檔案還原至編輯前的檢查點狀態。

IntelliJ

如果已點選「檢查」接受變更,採用了 Google Chat 生成的程式碼建議,則可使用「復原」復原變更按鈕:

在 Gemini Code Assist 對話窗格中,依序點選「undo」和「Rollback Changes」。這會將程式碼檔案還原至編輯前的檢查點狀態。

IntelliJ Gemini Code Assist 中的「還原至檢查點」按鈕。

查看程式碼差異

根據預設,Gemini Code Assist 會以程式碼差異的形式,建議您變更程式碼。只要要求 Gemini Code Assist 變更程式碼,隨時都能觸發這項差異。

在本節中,您會提示 Gemini Code Assist 最佳化程式碼檔案、查看程式碼檔案中的差異,並視需要接受或拒絕變更。

VS Code

  1. 開啟程式碼檔案後,提示 Gemini Code Assist 執行以下操作: optimize this file。如要最佳化多個檔案和資料夾,請提示 Gemini Code Assist optimize @FILE1 and @FILE2

    Gemini Code Assist 會根據提示詞,在程式碼檔案中提供程式碼變更建議,並以內嵌差異說明這些變更。

  2. 在程式碼檔案中,按一下「接受」或「拒絕」

    在 VS Code Gemini Code Assist 中,接受或拒絕檔案中建議的單一變更。

  3. 如果 Gemini Code Assist 在程式碼檔案中建議多項變更,請按一下建議上方的「查看」,然後點選「下一個」或「上一個」,即可查看其他建議。

  4. 如要接受或拒絕所有建議變更,請按一下「接受檔案」或「拒絕檔案」

    在 VS Code Gemini Code Assist 中接受或拒絕檔案中的所有變更。

  5. 您也可以使用提示回覆中的「快速預覽」功能,接受或拒絕多個程式碼檔案中的所有建議。

    在 VS Code Gemini Code Assist 中快速預覽。

IntelliJ

  1. 開啟程式碼檔案後,提示 Gemini Code Assist 執行以下操作: optimize this file。如要最佳化多個檔案和資料夾,請提示 Gemini Code Assist optimize @FILE1 and @FILE2

    Gemini Code Assist 會根據提示詞,在程式碼檔案中提供程式碼變更建議,並以內嵌差異說明這些變更。

  2. 在程式碼檔案中,按一下「接受」或「拒絕」

    在 IntelliJ Gemini Code Assist 中,接受或拒絕檔案中的單一變更建議。

  3. 如果 Gemini Code Assist 在程式碼檔案中建議多項變更,請按一下 arrow_upwardarrow_downward,逐一查看其他建議。

    在 IntelliJ Code Gemini Code Assist 中,逐一查看檔案中的變更。

  4. 您也可以使用提示回覆中的「快速預覽」功能,接受或拒絕多個程式碼檔案中的所有建議。

    在 IntelliJ Code Gemini Code Assist 中快速預覽。

變更差異檢視設定

VS Code

如要變更這項設定,在 IDE 中顯示獨立的差異檢視視窗,請按照下列步驟操作:

  1. 在活動列中,依序前往「設定」>「設定」

  2. 在設定的「User」分頁中,依序前往「Extensions」>「Gemini Code Assist」

  3. 捲動至「Geminicodeassist」>「Chat: Change View」設定。

  4. 在下拉式選單中選取下列任一選項:

    • 內嵌建議 (預設為啟用):程式碼變更會顯示在程式碼檔案中。

    • 預設差異檢視畫面:開啟新檔案,並排顯示程式碼變更。

IntelliJ

  1. 在 Gemini Code Assist 側邊列的「Ask」面板中,按一下對話回覆中的「Preview in diff mode」按鈕 (compare_arrows)。

    主要程式碼窗格中會顯示「並排」分頁。

  2. 按一下「並列」分頁標籤,即可並列查看程式碼變更。

生成及查看檔案大綱

根據預設,Gemini Code Assist 會為 IDE 中焦點所在的檔案生成大綱。請注意,大綱不會在 IDE 工作階段之間保留,也就是說,除非停用自動生成大綱,否則每次啟動新工作階段時,系統都會為指定檔案生成新大綱。如要查看 Gemini Code Assist 生成的大綱,請按照下列步驟操作:

VS Code

VS Code 適用的 Gemini Code Assist 不支援這項功能。

IntelliJ

  1. 在 Gemini Code Assist 對話窗格中,按一下「Outline」分頁標籤。

    活動檔案的大綱會顯示在分頁中。

  2. (選用):按一下與檔案大綱相關聯的「眼睛」圖示,即可在程式碼檔案中內嵌顯示大綱。

  3. (選用):按一下「大綱」分頁旁邊顯示的「眼睛」圖示,即可在各自的程式碼檔案中,內嵌顯示所有可用的大綱。

如果變更含有大綱的檔案,系統不會自動產生新的大綱。「大綱」分頁會顯示「手動重新整理大綱」選項。

切換自動生成大綱功能

如要切換程式碼檔案的 Gemini Code Assist 大綱自動生成功能,請按照下列步驟操作:

VS Code

VS Code 適用的 Gemini Code Assist 不支援這項功能。

IntelliJ

  1. 在 IDE 中,依序前往「設定」>「工具」>「Gemini」

  2. 在「Gemini 設定」視窗中,切換「啟用自動生成大綱」

如果停用自動生成大綱功能,可以手動為焦點檔案生成大綱,方法是前往「大綱」分頁,然後按一下「生成大綱」

建立自訂指令

根據預設,Gemini Code Assist 會為 VS Code 提供 /generate 等指令,並為 IntelliJ 和其他支援的 JetBrains IDE 提供「產生程式碼」。您也可以建立自己的自訂指令,在 IDE 中更快完成重複性工作。

在本節中,您將建立名為 add-comments 的自訂指令,在程式碼檔案中加入註解。如果是 IntelliJ 和其他支援的 JetBrains IDE,您可以在提示程式庫和編輯器內提示中建立、儲存及執行自訂指令。

VS Code

  1. 在程式碼檔案中,按下 Ctrl + I 鍵 (Windows 和 Linux) 或 Command + I 鍵 (macOS),開啟 Gemini Code Assist 快速選取選單。

  2. 在選單中搜尋並選取「Preferences: Open Settings (UI)」

  3. 在「搜尋設定」欄位中輸入 Geminicodeassist: Custom Commands

  4. 在「自訂指令」方塊中,選取「新增項目」

  5. 在「Item」(項目) 欄位中,輸入 add-comments 做為指令名稱。

  6. 在「Value」(值) 欄位中,輸入 add comments to all functions without comments in my code 做為提示。

  7. 按一下 [確定]

您現在可以在 IDE 中使用自訂指令 add-comments。指令會顯示在 Gemini Code Assist 快速挑選選單的指令清單中 (Ctrl+I 鍵 (適用於 Windows 和 Linux) 或 Command+I 鍵 (適用於 macOS))。

IntelliJ

  1. 在 IDE 中,依序前往「設定」>「工具」>「Gemini」>「提示庫」

    IntelliJ Gemini Code Assist 的提示庫

  2. 在「提示範本庫」視窗中,按一下「新增」add

  3. 為自訂指令命名 add-comments

  4. 在提示詞庫的文字方塊中輸入提示: Add comments to all functions without comments in this code

  5. 如果未選取「在編輯器內提示中顯示」核取方塊,請選取該方塊。

  6. 按一下「確定」,將自訂指令儲存至提示庫。

  7. 在程式碼檔案中,醒目顯示要修改的程式碼。

  8. 在醒目顯示的程式碼上按一下滑鼠右鍵,然後依序前往「Gemini」>「提示庫」,然後選取自訂指令 add-comments

    Gemini Code Assist 會執行 add-comments 指令,並在醒目顯示的程式碼中加入註解。

您也可以透過下列步驟,使用編輯器內提示叫用自訂指令:

  1. 在程式碼檔案中,醒目顯示要修改的程式碼,然後按下 Alt+\ 鍵 (Windows 和 Linux) 或 Cmd+\ 鍵 (macOS),開啟 Gemini Code Assist 快速挑選選單。

  2. 在選單中選取自訂指令 add-comments

    Gemini Code Assist 會執行 add-comments 指令,並在醒目顯示的程式碼中加入註解。

在 Gemini Code Assist 對話窗格中,輸入 @ 即可從提示庫中擷取並使用已儲存的提示。

建立規則

您可以建立 Gemini Code Assist 遵循的規則,系統會在您輸入的每個對話提示中加入這些規則。

Gemini 的規則可讓你定義偏好設定,例如:

  • 程式碼樣式
  • 輸出格式
  • 技術堆疊
  • 語言

舉例來說,你可以建立「一律以 Kotlin 提供簡潔的回覆」這類規則。

VS Code

  1. 在程式碼檔案中,按下 Ctrl + I 鍵 (Windows 和 Linux) 或 Command + I 鍵 (macOS),開啟 Gemini Code Assist 快速選取選單。

  2. 在選單中搜尋並選取「Preferences: Open Settings (UI)」

  3. 在「搜尋設定」欄位中輸入 Geminicodeassist: Rules

  4. 在文字欄位中輸入規則,例如:Always generate unit tests when creating a new function。您也可以在文字欄位中新增一或多個規則,每行一個規則。

    在「規則」設定中新增規則後,Gemini Code Assist 會將規則套用至您發出的每個提示或要求。

    如要移除規則,請從「規則」文字欄位中刪除內容。

IntelliJ

  1. 如要建立規則,請依序前往「設定」>「工具」>「Gemini」>「提示庫」>「規則」,然後編輯編輯器中的文字。
  2. 如要設定規則的範圍,請在「範圍」下拉式選單中,選取「IDE」或「專案」

    • IDE 層級規則僅供您個人使用,且可套用至多個專案。
    • 專案層級的規則可供處理同一專案的團隊成員共用。

    如要與團隊共用提示,請將 .idea 資料夾新增至版本控管系統。

已知問題

本節說明 Gemini Code Assist 的已知問題:

VS Code

  • 如果大型開放式檔案的更新版本包含在對話回覆中,回覆內容可能會遭到截斷

    如要解決這個問題,請選取較小的程式碼區段,並在即時通訊提示中加入額外指令,例如 only output the selected code.

  • Vim:必須處於插入模式,才能接受或關閉程式碼生成建議

    在一般模式下使用 Vim 外掛程式時,您無法接受或關閉程式碼建議。

    如要解決這個問題,請按 i 鍵進入插入模式,然後按 Tab 鍵接受建議。

  • Vim:按下 Esc 鍵關閉建議時,行為不一致

    按下 Esc 鍵後,IDE 和 Gemini Code Assist 建議都會關閉。這與非 Vim 模式的行為不同,在非 Vim 模式中,按下 Esc 鍵會重新觸發 Gemini Code Assist。

  • 嘗試登入時持續發生逾時問題

    如果登入嘗試持續逾時,請嘗試在 settings.json 檔案中新增 cloudcode.beta.forceOobLogin 設定:

     "cloudcode.beta.forceOobLogin": true
    
  • 系統不會在不同工作階段中保留授權聲明警告

    如果授權背誦警告不會持續顯示,請參閱持續性記錄:

    1. 依序點選「查看」「輸出」

    2. 選取「Gemini Code Assist - Citations」(Gemini Code Assist - 引用內容)

  • Gemini Code Assist 輸出內容視窗中的連線問題

    如果在 Gemini Code Assist 輸出視窗中看到連線錯誤或其他連線問題,請嘗試下列方法:

    • 設定防火牆,允許存取 oauth2.googleapis.comcloudaicompanion.googleapis.com

    • 設定防火牆,允許透過 gRPC 使用的 HTTP/2 進行通訊。

    您可以使用 grpc-health-probe 工具測試連線。檢查成功會產生下列輸出內容:

    $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

    如果檢查失敗,會產生下列輸出內容:

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    如要取得更多詳細資料,請在 grpc-health-probe 前執行下列指令:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    
  • 選取 Gemini Code Assist 專案後,系統仍顯示「啟用 Gemini Code Assist」

    如果您已按照本指南中的操作說明選取專案 (包括啟用 Gemini for Google Cloud API),則可能是 LS 伺服器發生問題。

    如要進一步瞭解問題,請採取下列行動:

    1. 在狀態列中,點按 spark「Gemini Code Assist」,然後選取「Send feedback」(提供意見)

    2. 按一下任一記錄檔的「顯示」,即可查看更多詳細資料,協助排解問題。

IntelliJ

目前沒有已知的問題會影響 IntelliJ 和其他支援的 JetBrains IDE 專用 Gemini Code Assist。

提供意見

如要提供使用體驗的意見,請參閱「提供 Gemini for Google Cloud 意見回饋」。

後續步驟