> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 索引

当你打开项目时，Qoder 会自动为代码库建立索引，方法是生成文件嵌入向量。这使基于 AI 的代码理解、智能推荐和语义搜索成为可能。索引以增量方式进行，因此新建或已修改的文件会实时处理——无需人工干预。

<div id="configure-indexing">
  ## **配置索引**
</div>

1. 在 Qoder IDE 右上角，点击用户图标，或使用键盘快捷键（`⌘` `⇧` `,`（macOS）或 `Ctrl` `Shift` `,`（Windows）），然后选择 **Qoder 设置**。
2. 在左侧导航栏中，点击 **代码库索引**。
3. 选择以下之一：

* 若要手动启用索引，点击 **代码库索引** 旁的 **创建**。
* 若要启用持续的后台索引，将 **自动更新** 切换为开启。

> **注意：** **支持最多 100,000 个文件的代码库**。对于少于 10,000 个文件的代码库，自动更新默认开启。对于更大的代码库，需要手动启用索引。

<div id="ignore-files">
  ## **忽略文件**
</div>

默认情况下，Qoder 会为所有项目文件建立索引，但以下情况除外：

* `.gitignore` 中指定的文件和目录
* `.qoderignore` 中列出的文件

<div id="specify-custom-ignore-files">
  ### **指定自定义忽略文件**
</div>

你可以定义额外需要从索引中排除的文件或目录。

1. 在 Qoder IDE 的右上角，点击用户图标，或使用键盘快捷键（`⌘` `⇧` `,`（macOS）或 `Ctrl` `Shift` `,`（Windows）），然后选择 **Qoder 设置**。
2. 在左侧导航栏，点击 **代码库索引**。
3. 在 **忽略文件** 旁点击 **管理**。
4. 添加自定义匹配模式。

**模式示例**

| **格式**      | **描述**             |
| :---------- | :----------------- |
| config.json | 忽略特定文件             |
| dist/       | 忽略整个目录             |
| \*.log      | 忽略所有 .log 扩展名的文件   |
| \*\*/logs   | 忽略任意嵌套层级中的 logs 目录 |
| !app/       | 从忽略规则中排除某个路径（取反）   |

**要检查某个特定文件是否被忽略，请使用以下命令：**

`git check-ignore -v [file]`

<div id="faqs">
  ## **常见问题解答**
</div>

<div id="where-can-i-view-indexed-codebases">
  ### **我可以在哪里查看已建立索引的代码库？**
</div>

目前没有集中式的索引列表。你可以在各项目的索引设置中查看已建立索引的代码库。

<div id="is-my-source-code-stored-on-qoder-servers">
  ### **我的源代码会存放在 Qoder 的服务器上吗？**
</div>

不会。Qoder 不会存储你的源代码。