命令系统

Gemini CLI 的交互命令主要有三类：/ 控制 CLI 本身，@ 把文件或目录加入上下文，! 直接执行 Shell 命令。三者不要混用：上下文用 @，会话和配置用 /，系统命令才用 !。

flowchart LR
    Slash["/ slash commands"] --> Control["控制会话、配置、MCP、记忆"]
    At["@ file / dir"] --> Context["注入文件和目录上下文"]
    Bang["! shell"] --> Shell["直接执行系统命令"]

    style Slash fill:#dbeafe,stroke:#3b82f6
    style At fill:#dcfce7,stroke:#22c55e
    style Bang fill:#fef3c7,stroke:#f59e0b

1. slash commands

Slash commands 是 CLI 控制面。它们不等于给模型的业务需求，而是用来管理项目上下文、切换认证、控制工具、查看用量、恢复 checkpoint、重载配置。下表按"新手最先用 → 进阶"分组，完整 38 个命令以官方 Commands reference 为准。

起步必学（第一次启动后最先用这几条）：

模型与用量：

上下文与配置：

工具与权限：

扩展生态：

会话管理 / 排错：

界面调整（可选）：

2. @ 文件引用

典型写法：

• @src/components/UserProfile.tsx 解释这个组件如何处理 user data
• @src/types/User.ts @src/components/UserProfile.tsx 帮我检查类型是否一致
• @src/utils/ 检查这个目录里是否还有 deprecated API

@ 适合你已经知道路径时强制把文件放进上下文。如果不知道路径，可以直接让 Gemini CLI 先找。

@ 引用目录时要控制范围。不要一上来 @. 或把整个 monorepo 放进去；先指定一个文件、一个子目录或一组强相关文件。上下文越大，越容易浪费 token，也越容易把无关文件带进判断。

3. ! Shell 命令

常见写法包括 !ls -la、!git status、!npm test。

! 执行的命令会把输出放进当前 session，上下文里后续可以引用。输出太大时可能被截断。

4. 使用建议

• 查 CLI 能力先 /help。
• 修改上下文文件后用 /memory reload 或 /memory refresh。
• 接 MCP 后用 /mcp list 确认工具是否加载。
• 大改前先 /chat save <tag> 或启用 checkpoint。
• Shell 命令默认要确认，不要长期放开高风险命令。

一个稳的日常顺序是：

1. 用 @ 指定文件。
2. 让 Gemini CLI 只读解释。
3. 用 /memory show 或 /memory reload 确认规则。
4. 用 !git status、!npm test 获取事实。
5. 再授权小范围修改。

5. 接下来去哪

官方来源

• Gemini CLI Commands Reference
• Gemini CLI Cheatsheet