Gemini CLI 速查表
最常用 Gemini CLI 命令和标志的快速参考指南。
基本用法
gemini "您的提示词"
最基本的命令。向 Gemini 模型发送提示词并打印响应。
示例:gemini "世界上最大的5个城市是什么?"
npx @google/generative-ai '...'
无需永久安装即可运行 Gemini CLI。非常适合快速测试或不频繁使用。
示例:npx @google/generative-ai "为一个科技博客推荐一个好名字。"
文件和输入处理
gemini -f [FILE_PATH] '...'
将文件内容作为提示词上下文的一部分。文件内容会添加到您的提示词前面。
示例:gemini -f readme.md "总结这个 README 文件。"
cat [FILE_PATH] | gemini '...'
将文件内容(或任何标准输出)直接通过管道传递给 Gemini CLI 作为上下文。
示例:cat package.json | gemini '解释这些依赖项的用途。'
gemini --files="file1.py,file2.py" "比较这些文件"
发送多个文件给 Gemini 进行分析。
示例:gemini --files="v1.js,v2.js" "版本之间有什么变化?"
输出控制
gemini --json "从这段文本中提取数据"
请求以 JSON 格式输出,便于在脚本中解析。
示例:gemini --json "从以下内容中提取姓名、电子邮件和电话:张三,zhangsan@example.com,555-1234"
gemini --markdown "生成文档"
请求以 Markdown 格式输出。
示例:gemini --markdown "为 REST API 编写文档"
gemini --code-only "生成一个函数"
只输出代码块,不包含解释性文本。
示例:gemini --code-only "编写一个计算斐波那契数列的 Python 函数"
模型控制
gemini --model=gemini-1.5-pro "复杂问题"
指定使用哪个 Gemini 模型。
示例:gemini --model=gemini-1.5-flash "总结这段文字"
gemini --temperature=0.7 "创意故事"
控制响应中的随机性(0.0-1.0)。较低的值更具确定性。
示例:gemini --temperature=0.9 "写一个科幻短篇故事"
gemini --max-tokens=500 "长回答"
限制响应的长度。
示例:gemini --max-tokens=100 "总结这篇文章"
高级用法
gemini --system="你是一个有帮助的助手" "您的提示词"
设置系统提示以指导模型的行为。
示例:gemini --system="你是一个 Python 专家" "帮我解决这段代码"
gemini --save=mychat "开始一个对话"
保存对话以便稍后继续。
示例:gemini --save=project-planning "让我们规划一个新的网络应用"
gemini --load=mychat "继续我们的讨论"
继续之前保存的对话。
示例:gemini --load=project-planning "我们讨论的关键功能是什么?"
系统和网络工具
gemini '以表格形式列出当前目录中的文件'
执行 `ls` 命令并理解其输出。您可以要求特定格式或分析。
示例:gemini '递归显示 src 文件夹的内容,并识别任何 .css 文件'
gemini '在 `components` 目录中查找所有 `useState` 实例'
在文件中执行 `grep` 搜索内容。对代码分析和发现很有用。
示例:gemini '在所有 `.ts` 文件中搜索文本 `TODO:`。'
gemini '在 `src/blog` 文件夹中查找所有 markdown 文件'
使用 glob 模式按路径查找文件。代理通常会读取或分析这些文件。
示例:gemini '读取博客中的所有 `.md` 文件并给我每个文件的摘要。'
gemini '搜索网络上关于 AI 的最新新闻'
使用 Google 搜索执行网络搜索,回答关于时事或最新信息的问题。
示例:gemini '上次 Google I/O 活动的主要公告是什么?'
gemini '记住我更喜欢使用 pnpm 进行包管理。'
允许代理记住特定事实或偏好以供将来交互。
示例:gemini '从现在开始,当你建议安装包时,使用 pnpm。' '好的,我会记住使用 pnpm。'
gemini '运行命令 `npm run test` 并告诉我是否成功。'
执行任意 shell 命令并分析其输出。这是一个非常强大但可能危险的工具。
示例:gemini '使用 npm 安装 `is-odd` 包,然后编写一个 node 脚本来使用它。'
专业技巧
export GOOGLE_API_KEY="YOUR_KEY"
将您的 API 密钥设置为环境变量,这样您就不必在每个命令中提供它。
示例:将此添加到您的 .bashrc 或 .zshrc 文件中以保持持久性。
gemini -f code.js "重构这段代码。只输出原始的更新代码。"
使用提示来控制输出格式。要求'原始代码'有助于将输出直接管道传输到新文件中。
示例:gemini -f old.py "..." > new.py