官方教學中文版上下文與設定
上下文與設定
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。