GeminiCLI.net

如何使用 Gemini CLI 為您的 VS Code 工作流程「超級充電」

作者：Gemini 指南，發布於 2025/6/25

Visual Studio Code 是數百萬開發者的首選編輯器，因其靈活性和強大的整合式終端機而備受讚譽。雖然您總可以在獨立的終端機視窗中使用 Gemini CLI，但真正的生產力提升來自於將其直接整合到您的編碼工作流程中。

本指南將向您展示如何在 VS Code 中使用 Gemini CLI，以創造無縫、由 AI 驅動的開發體驗。

基礎：使用整合式終端機

使用 Gemini CLI 最直接的方法是在 VS Code 的整合式終端機中。您可以透過按下 Ctrl+` (Control + 反引號) 來開啟它。

在這裡，您可以使用 CLI 所有基於檔案的功能，而無需離開您的編輯器。

使用案例 1：解釋一個複雜的檔案

繼承了一個舊的程式碼庫或正在探索一個新的函式庫？取得任何開啟檔案的概要解釋。

  1. 開啟您想要理解的檔案（例如，src/utils/complex-logic.js）。
  2. 在整合式終端機中，執行：
gemini -f src/utils/complex-logic.js "提供此檔案用途及其主要功能的高階摘要。"

使用案例 2：重構當前檔案

有一段可以運作但感覺雜亂的程式碼？讓 Gemini 提出改進建議。

gemini -f src/components/old-component.jsx "將此 React 元件重構為使用現代最佳實踐，包含 hooks。僅輸出原始的、更新後的程式碼。"

然後，您可以複製輸出並取代您的舊程式碼，或使用 VS Code 的差異檢視來比較變更。

終極整合：VS Code 任務

雖然手動執行指令很有用，但真正的殺手鐧是建立自訂的 VS Code「任務」。這使您能夠透過單一指令或鍵盤快捷鍵，在當前活動檔案上執行複雜的 Gemini CLI 指令。

步驟 1：建立您的 tasks.json 檔案

  1. 按下 Ctrl+Shift+P 開啟命令面板。
  2. 輸入 "Tasks: Configure Task" 並按下 Enter。
  3. 選擇 "Create tasks.json file from template"。
  4. 選擇 "Others"。

這將在您專案的根目錄中建立一個 .vscode/tasks.json 檔案。

步驟 2：定義您的 Gemini 任務

用以下設定取代新 tasks.json 檔案的內容。這定義了三個有用的任務：gemini:explain、gemini:refactor 和 gemini:docs。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "gemini:explain",
      "type": "shell",
      "command": "gemini -f ${file} \"Explain this code to me. Focus on the core logic and any potential edge cases.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    },
    {
      "label": "gemini:refactor",
      "type": "shell",
      "command": "gemini -f ${file} \"Refactor this code to improve readability, efficiency, and adherence to best practices. Only output the raw code.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    },
    {
      "label": "gemini:docs",
      "type": "shell",
      "command": "gemini -f ${file} \"Generate professional documentation for this file in Markdown format. Include a description of the file's purpose, its functions/classes, their parameters, and what they return.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    }
  ]
}

關鍵魔法： ${file} 變數是一個特殊的 VS Code 變數，它會自動替換為您在編輯器中當前開啟的檔案路徑。

步驟 3：執行您的任務

現在，開啟任何程式碼檔案：

  1. 按下 Ctrl+Shift+P 開啟命令面板。
  2. 輸入 "Tasks: Run Task" 並按下 Enter。
  3. 您將看到您的三個 Gemini 任務：gemini:explain、gemini:refactor 和 gemini:docs。
  4. 選擇一個。一個新的終端機面板將會開啟，並在您的活動檔案上執行該指令！

視覺化指南：觀看實際操作

若要觀看如何在 VS Code 中充分利用終端機的視覺化演練，請查看這個優秀的教學影片：

Video Tutorial: Master VS Code Terminal: PowerShell, Git Bash, and Command Line Tips for Developers

為了更快速地存取，您可以為每個任務指派鍵盤快捷鍵。

透過將 Gemini CLI 直接帶入您的編輯器，您可以建立一個強大的、客製化的、深度整合的 AI 助理，以適應您的個人工作流程。建立 VS Code 任務是邁出的重要第一步。下一個層級是為更複雜的工作建構獨立的 shell 指令碼。在我們的終極自動化指南：在您的指令碼中使用 Gemini CLI中學習如何操作。這個相同的原則可以進一步擴展，例如，直接從您的終端機自動化您的 Google Workspace 任務。

分享本文：