gemini- CLI 常用命令

高频命令

1. 提供上下文与对话 (最高频)

这是与 Gemini CLI 交互最核心的方式。

1 @path/to/your/file.js

说明: 这是最强大的命令之一。使用 @ 符号可以告诉 Gemini
读取一个或多个文件/目录的内容，并将其作为当前对话的上下文。你可以用它来提问、请求代码修改等。

示例:

1 > @src/user/service.ts Can you add error handling to the updateUser method?
2 > @src/components/ @package.json Please create a new component that matches the existing style and add the
required dependencies.

1 Can you write a function that sorts an array of objects by a specific key?

说明: 任何不以特殊字符 (@, !, /) 开头的文本都会被当作直接发送给 AI 的自然语言指令或问题。

示例:

1 > How do I set up a React project with Vite?

2. 执行本地命令

直接在你的终端环境中执行命令，无缝集成开发工作流。

1 !npm run test

说明: 使用 ! 前缀可以直接执行任何终端命令，比如运行测试、安装依赖、查看文件列表、提交代码等。

示例:

1 > !ls -a
2 > !git status
3 > !pip install -r requirements.txt

3. 获取帮助和信息

当你需要了解 CLI 的功能时使用。

1 /help

说明: 输入 /help 会列出所有用户可以使用的命令及其简要说明，是快速查找命令的首选。

1 /tools

说明: 显示当前 AI（我）可以使用的所有工具（如 read_file, run_shell_command 等）。这有助于你了解 AI 的能力范围。

4. 配置与管理 (较少使用)

1 # In your project root, create a file named gemini.md

说明: 你可以在项目的根目录创建一个 gemini.md 文件。Gemini CLI
会在启动时读取这个文件，你可以用它来提供项目的特定指令、上下文或规则，例如：“Always use TypeScript for new files.” 或
“The primary testing framework is Jest.”。

---

总结

您日常使用最高频的命令是：

• 直接对话: 提出问题或给出指令。
• @: 引用文件或目录以提供上下文。
• !: 在终端中执行命令。
• /help: 查看所有可用命令。