本文說明如何使用 Gemini Code Assist Standard 和 Enterprise (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 Workstations 和 Android Studio 中探索 Gemini Code Assist。
事前準備
VS Code
在程式碼檔案中測試 Gemini Code Assist 功能前,請確認檔案的程式設計語言是否受到支援。如要進一步瞭解支援的程式語言,請參閱「支援的程式語言」。
如果您偏好在 Proxy 後方使用 IDE,請參閱「Visual Studio Code 中的網路連線」。
IntelliJ
在程式碼檔案中測試 Gemini Code Assist 功能前,請確認檔案的程式設計語言是否受到支援。如要進一步瞭解支援的程式語言,請參閱「支援的程式語言」。
如要在 Proxy 後方使用 IDE,請參閱「HTTP Proxy」。
使用提示生成程式碼
以下章節說明如何使用 Gemini Code Assist,在程式碼檔案中透過 Function to create a Cloud Storage
bucket
範例提示生成程式碼。您也可以選取部分程式碼,然後透過對話功能提示 Gemini Code Assist 提供協助,並在編寫程式碼時接收及接受或拒絕程式碼建議。
提示 Gemini Code Assist 轉換程式碼
程式碼轉換功能可讓您在「快速挑選」選單中使用指令或自然語言提示,要求修改程式碼,並提供差異檢視畫面,顯示程式碼的待處理變更。如要提示 Gemini Code Assist 轉換程式碼,請按照下列步驟操作:
VS Code
在程式碼檔案的新行中,按下 Ctrl + I 鍵 (Windows 和 Linux) 或 Command + I 鍵 (macOS),開啟 Gemini Code Assist 快速挑選選單。
在選單中,使用
/generate
指令輸入/generate function to create a Cloud Storage bucket
,然後按下 Enter 鍵 (適用於 Windows 和 Linux) 或 Return 鍵 (適用於 macOS)。Gemini Code Assist 會根據提示,在差異檢視畫面中生成程式碼。
選用:如要接受這些變更,請按一下「接受」。
IntelliJ
在程式碼檔案的新行中,按下 Alt+\ 鍵 (適用於 Windows 和 Linux) 或 Cmd+\ 鍵 (適用於 macOS),開啟 Gemini Code Assist 快速挑選選單。
在選單中,使用
/generate
指令輸入/generate function to create a Cloud Storage bucket
,然後按下 Enter 鍵 (適用於 Windows 和 Linux) 或 Return 鍵 (適用於 macOS)。Gemini Code Assist 會根據提示,在差異檢視畫面中生成程式碼。
選用:如要接受這些變更,請按一下「接受變更」。
您可以在 IDE 中使用下列程式碼轉換指令:
/fix
:修正程式碼中的問題或錯誤。範例:/fix potential NullPointerExceptions in my code
。/generate
:產生程式碼。範例:/generate a function to get the current time
。/doc
:在程式碼中加入說明文件。範例:/doc this function
。/simplify
:簡化程式碼。範例:/simplify if statement in this code
。
在程式碼檔案中透過註解提示 Gemini Code Assist
如要透過註解提示程式碼檔案中的 Gemini Code Assist,請按照下列步驟操作:
VS Code
在新的一行中輸入註解
Function to create a Cloud Storage bucket
,然後按下 Enter 鍵 (Windows 和 Linux) 或 Return 鍵 (macOS)。如要生成程式碼,請按下 Control+Enter 鍵 (適用於 Windows 和 Linux) 或 Control+Return 鍵 (適用於 macOS)。
在程式碼檔案中,Gemini Code Assist 會在提示文字旁以虛線文字的形式生成程式碼。
選用:如要接受生成的程式碼,請按下 Tab 鍵。
IntelliJ
在程式碼檔案的新行中,輸入註解
Function to create a Cloud Storage bucket
。如要生成程式碼,請按 Alt + G 鍵 (適用於 Windows 和 Linux) 或 Option + G 鍵 (適用於 macOS)。或者,您也可以在註解旁按一下滑鼠右鍵,然後選取「Generate Code」。
Gemini Code Assist 會在註解下方以虛影文字的形式生成程式碼。
選用:如要接受生成的程式碼,請按下 Tab 鍵。
選用:變更產生程式碼的鍵盤快速鍵
如果產生程式碼的預設鍵盤快速鍵無法正常運作,如上一節所述,您可以變更鍵盤快速鍵。
取得程式碼補全建議
您編寫程式碼時,Gemini Code Assist 會提供內嵌程式碼建議 (也稱為程式碼補全),您可以接受或忽略。如要取得程式碼自動完成建議,請按照下列步驟操作:
VS Code
在程式碼檔案中,於新的一行開始編寫函式。舉例來說,如果您在 Python 檔案中,請輸入
def
。Gemini Code Assist 會以虛影文字的形式建議程式碼。
如要接受 Gemini Code Assist 提供的程式碼建議,請按下 Tab 鍵。如要忽略建議,請按下 Esc 鍵或繼續撰寫程式碼。
IntelliJ
在程式碼檔案中,於新的一行開始編寫函式。舉例來說,如果您在 Python 檔案中,請輸入
def
。Gemini Code Assist 會以內嵌建議的形式提供程式碼建議。
如要接受 Gemini Code Assist 提供的程式碼建議,請按下 Tab 鍵。如要忽略建議,請按下 Esc 鍵或繼續撰寫程式碼。
選用:如要使用其他快速鍵接受行內建議,請將指標懸停在行內建議上,然後按一下顯示的「Tab」下拉式選單。然後選取偏好的快速鍵,或按一下「自訂」輸入自己的快速鍵。
選用:停用程式碼自動完成功能
程式碼自動完成功能預設為啟用,如要停用程式碼自動完成功能,請按照下列步驟操作:
VS Code
在 IDE 中,點按「Code」 (適用於 macOS) 或「File」 (適用於 Windows 和 Linux),然後依序前往「Settings」>「Settings」。
在「設定」對話方塊的「使用者」分頁中,依序選取「擴充功能」>「Gemini Code Assist」。
捲動畫面,直到找到「Duet AI:內嵌建議:啟用自動」清單,然後選取「關閉」。
這會關閉內嵌建議。您仍可按下 Ctrl+Enter 鍵 (Windows 和 Linux) 或 Ctrl+Return 鍵 (macOS),手動觸發行內建議。
IntelliJ
在 IDE 的狀態列中,依序點按「Gemini Code Assist: Active」(Gemini Code Assist:已啟用)spark 和「Enable AI Code Completion」(啟用 AI 程式碼自動完成)。
這會停用程式碼完成設定,且 Gemini Code Assist 不會再提供內嵌建議,直到您重新啟用設定為止。
使用智慧動作
為協助您提高工作效率並減少切換情境,Gemini Code Assist 會直接在程式碼編輯器中提供 AI 輔助智慧動作。在程式碼編輯器中選取程式碼時,您可以查看並選取與內容相關的動作清單。
如要在程式碼中使用智慧動作,請按照下列步驟操作:
VS Code
在程式碼檔案中選取程式碼區塊。
在選取的程式碼區塊旁,按一下「顯示程式碼動作」lightbulb。
選取動作,例如「產生單元測試」。
Gemini Code Assist 會根據您選取的動作生成回覆。
IntelliJ
在程式碼檔案中,選取一行或一段程式碼。
在所選程式碼上按一下滑鼠右鍵,然後選取智慧動作,例如「產生單元測試」。
選取智慧動作後,系統會自動提示 Gemini Code Assist 在 Gemini Code Assist 工具視窗中生成提示詞的回覆。
使用程式碼轉換快速修正
如果程式碼有錯誤,Gemini Code Assist 會提供快速修正選項,讓您透過程式碼轉換修正錯誤。
如要在程式碼檔案中套用快速修正,請按照下列步驟操作:
VS Code
在程式碼檔案中,將指標懸停在錯誤的波浪線上方,然後依序選取「快速修正」和「/fix」。
套用快速修正後,系統會顯示差異檢視畫面。如要接受這些變更,請按一下「接受」。
IntelliJ
在程式碼檔案中,按一下紅色錯誤燈泡圖示 (表示程式碼有錯誤),然後選取「使用 Gemini 修正」。
套用修正後,系統會顯示差異檢視畫面。如要接受這些變更,請按一下「接受」。
從本機內容排除檔案
根據預設,如果檔案是在 .aiexclude
或 .gitignore
檔案中指定,Gemini Code Assist 會排除這些檔案,不將其用於程式碼自動完成、程式碼生成、程式碼轉換和對話的背景資訊。
如要瞭解如何排除本機檔案,請參閱「排除 Gemini Code Assist 使用的檔案」。
停用與引用來源相符的程式碼建議
如果 Gemini Code Assist 直接引用其他來源的長篇內容 (例如現有的開放原始碼),就會提供引用資訊。詳情請參閱「Gemini 引用來源的方式和時機」。
如要避免系統根據引用的來源建議程式碼,請按照下列步驟操作:
在 IDE 的活動列中,依序點按「管理」>「設定」。
在設定視窗的「User」分頁中,依序前往「Extensions」>「Gemini Code Assist」。
捲動畫面,直到找到「Geminicodeassist」>「Recitation: Max Cited Length」。
將值設為
0
。Gemini Code Assist 不再建議與引用來源相符的程式碼。
已知問題
本節說明 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
授權背誦警告不會跨工作階段保留
如果授權背誦警告不會持續顯示,請參閱持續性記錄:
依序點選「查看」>「輸出」。
選取「Gemini Code Assist - Citations」(Gemini Code Assist - 引文)。
Gemini Code Assist 輸出內容視窗中的連線問題
如果在 Gemini Code Assist 輸出視窗中看到連線錯誤或其他連線問題,請嘗試下列方法:
設定防火牆,允許存取
oauth2.googleapis.com
和cloudaicompanion.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 伺服器發生問題。
如要進一步瞭解問題,請採取下列行動:
在狀態列中,點按 spark「Gemini Code Assist」,然後選取「Send feedback」(提供意見)。
按一下任一記錄檔的「顯示」,即可查看更多詳細資料,協助排解問題。
IntelliJ
目前沒有已知的問題會影響 IntelliJ 和其他支援的 JetBrains IDE 使用 Gemini Code Assist。
提供意見
如要提供使用體驗的相關意見,請按照下列步驟操作:
VS Code
你可以透過下列任一方式提供意見:
- 在狀態列中,依序點按 spark「Gemini Code Assist」,然後在「快速挑選」選單中選取「提供意見」。
- 開啟指令面板 (
Ctrl
/Command
+Shift
+P
),然後選取「Gemini Code Assist: Send Feedback」。
在表單中填寫「標題」和「留言」欄位。
在「Gemini Code Assist 意見回饋」表單中,從「意見回饋類別」和「類型」下拉式選單中選取選項。
在「Comment」(意見) 欄位中詳述你的體驗。
請務必在意見回饋報告中附上 Gemini Code Assist 記錄。系統預設會選取這個選項。
視需要勾選或取消勾選其他選項。
按一下「提交意見回饋」。
IntelliJ
在狀態列中,按一下 spark「Gemini Code Assist」。
在即時通訊中提示 Gemini Code Assist 後,如果對回覆不滿意,請依序點選「thumb_down」thumb_down「不滿意」「提供意見回饋」。
在表單頂端的文字欄位中輸入意見回饋。
如要分享 Gemini Code Assist 記錄,請務必選取記錄檔。
按一下「提交意見回饋」。
後續步驟
- 瞭解如何撰寫更優質的提示。
- 瞭解 Gemini for Google Cloud 如何使用您的資料。
- 瞭解 Gemini Code Assist 定價。
- 進一步瞭解Google Cloud 法規遵循。