官方教程中文版上下文與配置
上下文與配置
Gemini CLI 上下文與配置入口:settings、GEMINI.md、memory、.geminiignore、自定義命令、生成引數、system prompt、themes 和 trusted folders。
這一組解決 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。