官方教程中文版上下文与配置
上下文与配置
Gemini CLI 上下文与配置入口:settings、GEMINI.md、memory、.geminiignore、自定义命令、生成参数、system prompt、themes 和 trusted folders。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 上下文与配置 | context & config | 配置和上下文相关能力的总览。 |
| 按需选用 | pick | 按需求选该配什么。 |
| 安全优先 | safe | 涉及信任和敏感的优先收紧。 |
不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你按需求在 Gemini CLI 的上下文与配置各能力里定位该用什么。
你是 Gemini CLI 上下文与配置导航顾问。
【角色】
Gemini CLI 上下文与配置导航顾问,按最小够用、安全优先的原则给可落地方案,每条结论都落到能照做的步骤或示例,不停留在空泛建议。
【输入】
- 我的需求(配行为 / 给上下文 / 管记忆 / 保安全):___
- 使用场景(个人 / 团队):___
- 涉及敏感文件或信任问题吗:___
- 经验水平:___
- 现状:___
【工作流程】
1. 把需求归到对应配置能力
2. 指出该先配什么
3. 提示和其他配置的关联
4. 涉及安全 / 信任时优先收紧
5. 给落地下一步
【输出规范】
▌一、需求归类
▌二、该先配什么
▌三、配置间的关联
▌四、落地下一步
【硬约束】
- 安全 / 信任相关优先收紧
- 长期约定进 GEMINI.md,不每次重复
- 一次聚焦一个配置
- 不要替我臆测情况或编造不存在的配置项,信息不全先问清
- 不确定的配置或字段一律以官方文档为准,禁止照搬过时写法这一组解决 Gemini CLI 能不能长期稳定使用。一次性 prompt 只能解决当前任务;GEMINI.md、settings、memory、自定义命令和 ignore 文件,才是把经验沉淀下来的地方。
核心原则:反复说的项目规则写进 GEMINI.md;行为开关写进 settings;不该读的文件写进 .geminiignore;重复任务写成 custom command。
学习路径
flowchart LR
Rules["GEMINI.md"] --> Settings["settings.json"]
Settings --> Memory["memory"]
Memory --> Ignore[".geminiignore"]
Ignore --> Commands["custom commands"]
Commands --> Advanced["generation / system prompt"]
Advanced --> Trust["themes / trusted folders"]
Trust --> Tools["tools / MCP"]
style Rules fill:#dbeafe,stroke:#3b82f6
style Ignore fill:#fee2e2,stroke:#ef4444
style Commands fill:#dcfce7,stroke:#22c55e
分层建议
一次性 prompt 当前任务临时要求
GEMINI.md 项目长期规则和工作方式
settings.json CLI 行为、模型、工具、MCP、权限配置
.geminiignore 不让 Gemini CLI 读取的文件
custom commands 重复执行的任务入口规则与行为分层
先区分 GEMINI.md、settings、memory 和 prompt 的职责。
上下文安全边界
继续看 memory、.geminiignore 和 trusted folders。
可复用操作
把重复任务沉淀为 custom commands,再考虑扩展和 MCP。
页面清单
| 页面 | 解决的问题 |
|---|---|
| Settings | CLI 行为、模型、工具、MCP、权限配置放哪里 |
| GEMINI.md | 项目长期规则和上下文如何沉淀 |
| Memory management | 长期记忆、auto memory、/memory reload 边界 |
| .geminiignore | 排除敏感文件、大文件和不该读的上下文 |
| Custom commands | 把重复任务变成 slash command |
| Generation settings | 什么时候调模型生成参数 |
| System prompt override | 高级 system prompt 替换的风险 |
| Themes | 终端 UI 和教程截图一致性 |
| Trusted folders | workspace 信任和 safe mode 边界 |
下一步
先读:Settings。