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

# Windsurf Ignore

> 通过使用采用 gitignore 风格语法的 .codeiumignore 文件，配置 Windsurf 在建立索引时应忽略的文件和目录。

<div id="windsurfignore">
  ## WindsurfIgnore
</div>

默认情况下，Windsurf 索引会忽略：

* 在 `gitignore` 中指定的路径
* `node_modules` 中的文件
* 隐藏路径名（以“.”开头）

当文件被忽略时，它既不会被索引，也不会计入“索引的最大工作区大小”的文件数量。
包含在 `.gitignore` 中的文件无法被 Cascade 编辑。

如果你想进一步配置需要被 Windsurf 索引忽略的文件，可以在代码仓库根目录添加一个 `.codeiumignore` 文件，其语法与 `.gitignore` 相同。

<Frame>
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/codeiumignore.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=9b6143bd6f701e4f25cf93825ee6fde6" width="732" height="450" data-path="assets/codeiumignore.png" />
</Frame>

<div id="global-codeiumignore">
  ### 全局 .codeiumignore
</div>

针对管理多个代码库的 Enterprise 客户，您可以在 `~/.codeium/` 文件夹中放置一个全局 `.codeiumignore` 文件，以在所有代码库中统一强制执行忽略规则。该全局配置将应用于您系统上的所有 Windsurf 工作区。

全局 `.codeiumignore` 文件使用与 `.gitignore` 相同的语法，并会与各代码库内的 `.codeiumignore` 文件共同生效。

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

首次启用时，Windsurf 在为工作区建立索引期间会占用少量 CPU。根据工作区大小，这通常需要 5–10 分钟，每个工作区仅需执行一次。CPU 使用率会自动恢复正常。Windsurf 索引还需要一定内存（5000 个文件的工作区约需 300MB RAM）。

“Max Workspace Size (File Count)” 设置用于确定 Windsurf 索引尝试为某个工作区/模块建立索引时允许的最大工作区规模。如果你的工作区似乎未被索引，请尝试将该数值调高。对于约 10GB RAM 的用户，我们建议将其设置为不超过 10,000 个文件。