GeminiCLI.net

如何使用 Gemini CLI 为您的 VS Code 工作流“超级充电”

blog.postMeta

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 任务。

SocialShare.shareArticle