---
title: "上下文與配置"
description: "Gemini CLI 上下文與配置入口：settings、GEMINI.md、memory、.geminiignore、自定義命令、生成引數、system prompt、themes 和 trusted folders。"
verifiedAt: "2026-05-09"
---

這一組解決 Gemini CLI 能不能長期穩定使用。一次性 prompt 只能解決當前任務；`GEMINI.md`、settings、memory、自定義命令和 ignore 檔案，才是把經驗沉澱下來的地方。

> [!NOTE]
> **核心原則**：反覆說的專案規則寫進 `GEMINI.md`；行為開關寫進 settings；不該讀的檔案寫進 `.geminiignore`；重複任務寫成 custom command。

## 學習路徑

```mermaid
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
```

## 分層建議

```text
一次性 prompt       当前任务临时要求
GEMINI.md           项目长期规则和工作方式
settings.json       CLI 行为、模型、工具、MCP、权限配置
.geminiignore       不让 Gemini CLI 读取的文件
custom commands     重复执行的任务入口
```

<Cards>
  <Card title="規則與行為分層" description="先區分 GEMINI.md、settings、memory 和 prompt 的職責。" href="/zh-Hant/docs/gemini-cli/official/02-context-config/20-settings" />
  <Card title="上下文安全邊界" description="繼續看 memory、.geminiignore 和 trusted folders。" href="/zh-Hant/docs/gemini-cli/official/02-context-config/22-memory-management" />
  <Card title="可複用操作" description="把重複任務沉澱為 custom commands，再考慮擴充套件和 MCP。" href="/zh-Hant/docs/gemini-cli/official/02-context-config/24-custom-commands" />
</Cards>

## 頁面清單

| 頁面 | 解決的問題 |
| --- | --- |
| [Settings](/zh-Hant/docs/gemini-cli/official/02-context-config/20-settings) | CLI 行為、模型、工具、MCP、許可權配置放哪裡 |
| [GEMINI.md](/zh-Hant/docs/gemini-cli/official/02-context-config/21-gemini-md) | 專案長期規則和上下文如何沉澱 |
| [Memory management](/zh-Hant/docs/gemini-cli/official/02-context-config/22-memory-management) | 長期記憶、auto memory、`/memory reload` 邊界 |
| [.geminiignore](/zh-Hant/docs/gemini-cli/official/02-context-config/23-gemini-ignore) | 排除敏感檔案、大檔案和不該讀的上下文 |
| [Custom commands](/zh-Hant/docs/gemini-cli/official/02-context-config/24-custom-commands) | 把重複任務變成 slash command |
| [Generation settings](/zh-Hant/docs/gemini-cli/official/02-context-config/25-generation-settings) | 什麼時候調模型生成引數 |
| [System prompt override](/zh-Hant/docs/gemini-cli/official/02-context-config/26-system-prompt) | 高階 system prompt 替換的風險 |
| [Themes](/zh-Hant/docs/gemini-cli/official/02-context-config/27-themes) | 終端 UI 和教程截圖一致性 |
| [Trusted folders](/zh-Hant/docs/gemini-cli/official/02-context-config/28-trusted-folders) | workspace 信任和 safe mode 邊界 |

## 下一步

先讀：[Settings](/zh-Hant/docs/gemini-cli/official/02-context-config/20-settings)。

## 官方來源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
