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

# Devin Desktop .devinignore

> 使用 .devinignore 文件，通过 gitignore 风格的语法指定 Devin Desktop 在建立索引和 Agent 访问时要排除的文件和目录。

<h2 id="default-ignore-rules">
  默认忽略规则
</h2>

默认情况下，Devin Desktop 索引会忽略以下内容：

* `.gitignore` 中列出的路径
* `node_modules` 中的文件
* 隐藏路径名 (以 “.” 开头)

被忽略的文件不会被建立索引。此外，agent 也无法编辑与 `.gitignore` 匹配的文件。

<h2 id="devinignore">
  `.devinignore`
</h2>

如需排除更多文件，请在代码仓库根目录下添加 `.devinignore` 文件，其语法与 `.gitignore` 相同：

```gitignore .devinignore theme={null}
# 生成的测试 fixture 和 vendor 第三方代码
experimental/**/testfiles/**
vendor/

# secrets 和本地配置
*.pem
.env.local
```

被 `.devinignore` 匹配的路径不会被纳入索引，Devin 也无法查看、编辑或创建这些路径。`.devinignore` 会与 `.gitignore` 同时生效，因此你只需列出尚未加入 gitignore 的路径。

<h2 id="global-ignore-rules">
  全局忽略规则
</h2>

对于需要管理多个仓库的 Enterprise 客户，你可以在 `~/.codeium/` 文件夹中放置一个全局 `.codeiumignore` 文件，从而对所有仓库强制执行忽略规则。该全局配置适用于你系统上的所有 Devin Desktop workspace。

全局 `.codeiumignore` 文件采用与 `.gitignore` 相同的语法，并会与各代码仓库专属的忽略文件同时生效。

<h2 id="system-requirements">
  系统要求
</h2>

首次启用时，Devin Desktop 会在为 workspace 建立索引期间占用少量 CPU。视 workspace 大小而定，此过程通常需要 5-10 分钟，且每个 workspace 只需执行一次。完成后 CPU 用量会自动恢复正常。Devin Desktop 索引还会占用一定内存 (包含 5000 个文件的 workspace 约需 300MB) 。

<Note>
  旧版的 `.windsurfignore` 和 `.codeiumignore` 文件仍会与 `.devinignore` 一同被读取并强制执行。现有文件可继续使用，但新规则建议写入 `.devinignore`。
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.