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

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

關(guān)于 .cursorignore

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

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

您可以在我們的 安全頁(yè)面 上閱讀更多關(guān)于此如何工作的內(nèi)容。

聊天和 Composer 上下文

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

有關(guān)我們?nèi)绾翁幚?AI 請(qǐng)求的更多信息，請(qǐng)?jiān)L問(wèn)我們的 安全頁(yè)面。

示例 ?.cursorignore? 文件

忽略特定文件

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

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

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

僅包含特定文件

僅包含 app 目錄中的 ?*.py? 文件。請(qǐng)注意，這與 ?.gitignore? 的語(yǔ)法相同。

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

故障排除

忽略文件的語(yǔ)法有時(shí)會(huì)有些混淆。?.cursorignore? 文件遵循與 ?.gitignore? 完全相同的語(yǔ)法，因此如果您嘗試使用忽略文件但它沒(méi)有按預(yù)期工作，我們建議您在 Google 上搜索該問(wèn)題，將搜索查詢(xún)中的 cursorignore 替換為 gitignore?？赡軙?huì)有人遇到過(guò)相同的問(wèn)題，StackOverflow 上會(huì)有好的答案。

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