Gemini CLI 详细操作手册
一、 核心概念理解
在使用这些命令之前，理解两个核心概念至关重要：
- 交互模式 (Chat Mode)：当您直接输入问题（不以
/开头）时，您处于聊天模式。这是与 Gemini 模型进行标准对话的方式。 - 命令模式 (Command Mode)：当您以斜杠
/开头输入时，您正在调用一个特定的功能。这些命令用于管理会话、与您的开发环境（IDE、文件系统）交互或更改工具的设置。
二、 命令分类与详解
我们将这些命令分为五大类，以便于理解和记忆。
第一类：会话与上下文管理 (Session & Context Management)
这类命令用于控制当前对话的内容和记忆。这是最常用也是最重要的一类命令。
| 命令 | 作用 | 详细说明与使用示例 |
|---|---|---|
/context |
管理对话的上下文信息 | 这是 Gemini CLI 的“记忆核心”。您可以将文件、网页甚至整个目录作为上下文，让 Gemini 基于这些信息回答问题。 子命令: • /context file <文件路径>: 添加一个文件。示例: > /context file ./src/main.js• /context dir <目录路径>: 添加一个目录下的所有文件。示例: > /context dir ./src• /context web <URL>: 添加一个网页内容。示例: > /context web https://gemini.google.com/faq• /context list: 显示当前已添加的所有上下文。• /context clear: 清空所有上下文信息。 |
/history |
管理历史对话记录 | 用于查看或清除您与 Gemini 的对话历史。 子命令: • /history list: 显示最近的对话记录。• /history clear: 清除所有保存的对话记录。 |
/clear |
清空当前屏幕和会话 | 这个命令会清除终端屏幕上的所有内容，并开始一个全新的对话（但不会清除用 /history 可见的已保存记录）。示例: > /clear (屏幕变干净，开始新话题) |
/retry |
重新生成上一个回答 | 如果您对 Gemini 上一次的回答不满意，可以使用此命令让它重新尝试生成一个不同的答案。 示例: > /retry |
第二类：IDE 集成 (IDE Integration)
这类命令用于连接和控制与 VS Code 的集成。这是实现代码生成、修改等强大功能的关键。
| 命令 | 作用 | 详细说明与使用示例 |
|---|---|---|
/ide |
管理与 VS Code 的连接 | 用于安装、启用或查看与 Gemini CLI Companion 扩展的连接状态。重要提示: 所有 /ide 相关命令都必须在 VS Code 的集成终端中运行才能成功。子命令: • /ide install: (不推荐) 尝试自动安装扩展，但经常失败。• /ide enable: 手动安装扩展后，用此命令启用连接。• /ide disable: 断开与 VS Code 扩展的连接。• /ide status: 查看当前的连接状态（已连接/已断开）。 |
第三类：代码与文件操作 (Code & File Operations)
这类命令让 Gemini CLI 能够直接与您的本地文件系统和命令行进行交互。
| 命令 | 作用 | 详细说明与使用示例 |
|---|---|---|
/run |
运行 AI 生成的代码块 | 当 Gemini 生成一个代码块（例如 ```python ... ````）时，此命令可以提取该代码块并执行它。它会提示您确认是否运行。<br><br>*示例*: 先问：“用 python 写一个打印 hello world 的脚本”，等 Gemini 回答后，输入> /run` |
/exec |
执行一条 shell 命令 | 直接在您的系统终端中执行一条命令，并将结果作为上下文返回给 Gemini，方便它分析命令输出。 安全警告: 请谨慎执行 AI 建议的命令！ 示例: > /exec ls -l (Gemini 将会看到当前目录的文件列表) |
/file |
操作本地文件 | 允许 Gemini 读取、写入或列出本地文件。 子命令: • /file read <文件路径>: 读取文件内容并显示。• /file write <文件路径>: 将 Gemini 上一个回答中的代码块写入指定文件（如果文件不存在则创建）。示例: 先让 Gemini 写一段代码，然后 > /file write ./new_script.py• /file list [目录路径]: 列出文件和目录。 |
/query |
将后续输入作为单次查询 | 强制将您的下一段输入（即使包含 /）视为一个普通的查询问题，而不是命令。示例: > /query 我想知道 /etc/passwd 文件在 Linux 中有什么用？ |
第四类：模型与配置 (Model & Configuration)
这类命令用于调整 Gemini CLI 的底层设置和模型参数。
| 命令 | 作用 | 详细说明与使用示例 |
|---|---|---|
/model |
查看或切换语言模型 | 您可以在不同的 Gemini 模型之间切换，例如在 gemini-1.0-pro 和 gemini-1.5-pro 之间选择。子命令: • /model list: 列出所有可用的模型。• /model set <模型名称>: 切换到指定的模型。示例: > /model set gemini-1.5-pro |
/temp |
调整模型的“温度” | “温度”控制回答的随机性。值越低（如 0.1），回答越确定、一致；值越高（如 0.9），回答越有创造性、越多样。 示例: > /temp 0.8 (让回答更有创意) |
/config |
管理工具的配置 | 用于设置或查看 Gemini CLI 的配置，例如是否启用数据收集。 子命令: • /config set data_collection false: 禁用数据收集。• /config get data_collection: 查看数据收集的当前设置。 |
第五类：帮助与信息 (Help & Information)
这类命令用于获取帮助和工具本身的信息。
| 命令 | 作用 | 详细说明与使用示例 |
|---|---|---|
/help |
显示帮助信息 | 最有用的命令之一！它可以显示所有可用命令的列表和简要说明。 示例: > /help |
/version |
显示工具版本 | 查看您当前安装的 gemini-cli 的版本号。示例: > /version |
/feedback |
提供反馈 | 提交您对这个工具的看法或遇到的问题。 示例: > /feedback |
三、 实用工作流示例
让我们把这些命令串联起来，模拟一个真实的开发场景：
项目开始，进入 VS Code 集成终端
cd /path/to/my-project
启用 IDE 集成
> /ide enable- (确保你已经手动安装了 Gemini CLI Companion 扩展)
让 Gemini 了解你的项目代码
> /context dir ./src- (现在 Gemini 知道
src目录下的所有代码了)
提出一个与项目相关的问题
> "在 App.js 文件中，如何添加一个处理点击事件的函数？"
Gemini 生成了代码，现在将它写入文件
- (假设 Gemini 回答了一个包含
function handleClick() { ... }的代码块) > /file write ./src/App.js- 注意: 这个命令会覆盖文件，请谨慎使用！更好的做法是先让它生成代码，然后手动复制粘贴。或者让它生成一个新文件：
> /file write ./src/newComponent.js
- (假设 Gemini 回答了一个包含
执行一个命令来检查项目依赖
> /exec npm list- (Gemini 现在看到了你的项目依赖列表，你可以基于此提问)
任务完成，开始一个新任务
> /clear- (清空屏幕和上下文，准备讨论下一个完全不同的话题)
希望这份详细的文档能帮助您完全掌握 Gemini CLI 的强大功能！建议您从第一类（会话与上下文管理）和第二类（IDE 集成）命令开始熟练使用，它们是日常工作中最高效的命令。如果忘记了任何命令，随时输入 /help 即可。