Gemini CLI 精细化命令操作手册
Gemini CLI 命令手册摘要 本手册详解 Gemini CLI 的核心命令，将其分为四类： 会话管理：/context 命令族管理AI的“短期记忆”，支持加载文件、目录或网页内容；/history 管理对话记录；/clear 和 /retry 重置会话或重试回答。 IDE与文件交互：/ide 连接VS Code；/file 读写本地文件；/run 执行代码块；/exec 运行Shell命令并
·
Gemini CLI 官方命令权威解读手册
本文档是对官方 commands.md 文件的深度解读和实战化扩充。
核心理念：从“对话”到“协同”
Gemini CLI 的 / 命令是其精髓所在。它将一个简单的聊天机器人，转变为一个能够深度集成在您开发环境中的“编程伙伴”。这些命令赋予了 Gemini 感知上下文、操作文件、执行代码、连接IDE的能力，实现了从“问答”到“协同工作”的飞跃。
这份手册将每个拥有子命令的命令（如 /context）拆分为一个“命令族”，首先介绍其整体作用，然后逐一、详细地解析每一个子命令。
第一类：会话与上下文管理 (Session & Context)
| 命令 (Command) | 核心作用 | 详细解读与实战示例 |
|---|---|---|
/context |
管理 AI 的“短期记忆” | 这是 Gemini CLI 的核心命令族，用于将外部信息（代码、文档等）加载到当前会话中，让 AI 的回答基于这些具体信息。 |
└─ ... file <路径> |
添加单个文件到上下文 | 适用于需要对特定文件进行分析、重构或提问的场景。 示例: “我需要重构这个JS文件，请先读取它。” > /context file ./src/utils/api.js> "分析此文件中的 fetchData 函数，有没有可以优化的地方？" |
└─ ... dir <路径> |
添加整个目录到上下文 | 适用于需要 AI 理解整个项目或模块架构的宏观场景。 示例: “帮我理解这个新项目的代码结构。” > /context dir ./server> "基于你读取的代码，为这个后端服务生成一份 API 端点文档。" |
└─ ... web <URL> |
添加一个网页内容到上下文 | 适用于让 AI 基于特定在线文档、文章或 API 文档进行回答。 示例: “根据 React 官方文档回答我的问题。” > /context web https://react.dev/learn> "总结一下 React Hooks 的主要使用规则。" |
└─ ... list |
列出当前已添加的上下文 | 用于检查你已经“喂”给了 AI 哪些资料，确保它拥有正确的背景信息。 示例: > /context list |
└─ ... clear |
清空所有上下文信息 | 当你要切换到一个完全不相关的新话题时，用此命令让 AI “忘记”之前的所有文件，避免信息干扰。 示例: > /context clear |
/history |
管理已保存的对话历史 | 用于回顾或永久删除您与 Gemini 的所有对话记录。 |
└─ ... list |
列出最近的对话历史 | 帮你快速找到之前的某次谈话。 示例: > /history list |
└─ ... clear |
永久删除所有对话历史 | 这是一个破坏性操作，请谨慎使用。 它会清空所有你与 Gemini 的历史记录。 示例: > /history clear |
/clear |
清空屏幕和当前会话 | 开启一个全新的、干净的对话界面，并重置上下文。 |
/retry |
重新生成上一个回答 | 对上一个回答不满意？让 AI 再试一次。 |
第二类：IDE 与文件系统交互 (IDE & Filesystem)
| 命令 (Command) | 核心作用 | 详细解读与实战示例 |
|---|---|---|
/ide |
管理与 VS Code 的连接 | 必须在 VS Code 集成终端中运行。用于建立 CLI 和 VS Code 扩展间的通信桥梁。 |
└─ ... status |
检查当前的连接状态 | 快速查看 CLI 是否已成功连接到 VS Code 扩展。 示例: > /ide status |
└─ ... enable |
启用与 VS Code 的连接 | 在手动安装 VS Code 扩展后，必须运行此命令来激活集成功能。 示例: > /ide enable |
└─ ... disable |
禁用与 VS Code 的连接 | 临时断开与 VS Code 扩展的连接。 示例: > /ide disable |
/file |
授权 AI 读写本地文件 | 允许 AI 直接与你的文件系统交互，实现代码的读取和保存。 |
└─ ... read <路径> |
读取指定文件的内容 | 将文件内容打印到终端，并自动添加到当前上下文中，方便后续提问。 示例: > /file read ./package.json |
└─ ... write <路径> |
写入内容到指定文件 | 将 AI 上一个回答中的代码块内容保存到本地文件。 注意：会无提示覆盖现有文件！ 示例: > "生成一个 .gitignore 文件用于 Node.js 项目"> /file write ./.gitignore |
└─ ... list [路径] |
列出目录下的文件和文件夹 | 让你或 AI 快速了解一个目录的结构。 示例: > /file list ./src |
/run |
执行上一个回答中的代码块 | 提取 AI 生成的脚本并运行它，执行前会有确认提示。 示例: > "用 shell 命令统计当前目录有多少个文件"> /run |
/exec <命令> |
执行任意 shell 命令并分析其输出 | 极其强大。执行命令并将结果喂给 AI，特别适合调试和环境分析。 安全警告：请勿执行任何你不理解的 AI 建议命令！ 示例: > /exec git status> "根据上面的 git 状态，帮我写一条合适的 commit message。" |
第三类：模型与配置 (Model & Configuration)
| 命令 (Command) | 核心作用 | 详细解读与实战示例 |
|---|---|---|
/model |
配置使用的语言模型 | 让你可以在不同的 Gemini 模型（如 1.0 Pro, 1.5 Pro）之间进行选择。 |
└─ ... set <模型名> |
切换到指定的模型 | 根据任务需求选择最合适的模型。 示例: > /model set gemini-1.5-pro-latest |
└─ ... list |
列出所有可用的模型 | 查看你当前可以选择哪些模型。 示例: > /model list |
/temp <0.0-1.0> |
调整回答的**“创意性”** | 低温 (如 0.2) = 严谨、一致；高温 (如 0.9) = 有创意、多样化。 |
/config |
管理工具的全局配置 | 设置 Gemini CLI 工具本身的行为。 |
└─ ... set <键> <值> |
设置一个配置项 | 主要用于开关数据收集等功能。 示例: > /config set data_collection false |
└─ ... get <键> |
获取一个配置项的值 | 查看当前的配置状态。 示例: > /config get data_collection |
第四类：通用与帮助 (General & Help)
| 命令 (Command) | 核心作用 | 详细解读与实战示例 |
|---|---|---|
/help |
显示所有命令的帮助信息 | 忘记命令时最好的提醒工具。 |
/query <问题> |
强制作为问题发送 | 当你的问题本身包含 / 时使用，避免被误判为命令。示例: > /query /etc/hosts 文件有什么用？ |
/version |
显示当前 CLI 的版本号 | 检查更新或报告问题时很有用。 |
/feedback |
向官方发送反馈 | 帮助改进 Gemini CLI 工具。 |
有“AI”的1024 = 2048，欢迎大家加入2048 AI社区
更多推荐
9
0- 0
已为社区贡献10条内容
所有评论(0)