如何使用 .cursorignore 文件從 Cursor 的代碼庫索引中排除特定文件和目錄

?.cursorignore? 文件允許您從 Cursor 的代碼庫索引中排除文件和目錄

關于 .cursorignore

要忽略文件以避免被包含在 代碼庫索引 中，您可以在項目的根目錄中使用 .cursorignore 文件。它的工作方式與 ?.gitignore? 對 git 的工作方式相同。

?.cursorignore? 尊重 ?.gitignore?。如果您已經有 ?.gitignore?，則默認情況下將忽略這些文件。如果您想忽略其他文件，可以將它們添加到 ?.cursorignore? 文件中。

您可以在我們的 安全頁面 上閱讀更多關于此如何工作的內容。

聊天和 Composer 上下文

目前，Cursor 聊天和 Composer 可以訪問其上下文中的所有文件，無論 ?.cursorignore? 設置如何。

有關我們如何處理 AI 請求的更多信息，請訪問我們的 安全頁面。

示例 ?.cursorignore? 文件

忽略特定文件

# 忽略 `dist` 目錄中的所有文件
dist/

# 忽略所有 `.log` 文件
*.log

# 忽略特定文件 `config.json`
config.json

僅包含特定文件

僅包含 app 目錄中的 ?*.py? 文件。請注意，這與 ?.gitignore? 的語法相同。

# 忽略所有內容
*
# 不忽略 app
!app/
# 不忽略 app 內的目錄
!app/*/
!app/**/*/
# 不忽略 Python 文件
!*.py

故障排除

忽略文件的語法有時會有些混淆。?.cursorignore? 文件遵循與 ?.gitignore? 完全相同的語法，因此如果您嘗試使用忽略文件但它沒有按預期工作，我們建議您在 Google 上搜索該問題，將搜索查詢中的 cursorignore 替換為 gitignore。可能會有人遇到過相同的問題，StackOverflow 上會有好的答案。

一個常見的例子：這是如何忽略所有文件，除了那些具有 ?.php? 擴展名的文件（僅添加 ?*? 后跟? !*.php? 不起作用，因為 ?gitignore? 文件發(fā)現器不會深入并發(fā)現子目錄中的任何 ?.php? 文件）。