AI 编程教程中文版
官方教程中文版上下文与配置

上下文与配置

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     重复执行的任务入口

页面清单

页面解决的问题
SettingsCLI 行为、模型、工具、MCP、权限配置放哪里
GEMINI.md项目长期规则和上下文如何沉淀
Memory management长期记忆、auto memory、/memory reload 边界
.geminiignore排除敏感文件、大文件和不该读的上下文
Custom commands把重复任务变成 slash command
Generation settings什么时候调模型生成参数
System prompt override高级 system prompt 替换的风险
Themes终端 UI 和教程截图一致性
Trusted foldersworkspace 信任和 safe mode 边界

下一步

先读:Settings

官方来源

本页目录