默认情况下，Cursor Chat 会包含当前文件作为上下文。你可以在发送时按 Alt/Option Enter 提交不包含上下文的查询，或在 Cursor 设置 > 功能 > 聊天 中开启 默认无上下文。以无上下文请求开始的聊天不会为任何消息添加上下文。

在输入时，你可以在输入框下方的标签中看到将包含的上下文。

添加上下文

默认情况下，用户消息会包含你输入的文本和引用的上下文。你可以使用 @ 符号为每个气泡添加更多自定义上下文，默认情况下，当前查看的文件也会作为上下文包含在用户消息中。

查看 @ 符号 页面了解更多信息。

AI 修复聊天

修复代码库中的 linter 错误的便捷功能是使用 AI 修复聊天。只需将鼠标悬停在编辑器中的错误上，点击出现的蓝色 AI 修复按钮即可。

快捷键是 Ctrl/⌘ + Shift + E。

长上下文聊天（测试版）

你可以通过 Cursor 设置 > 测试版 > 长上下文聊天 启用长上下文聊天。启用后，可以通过 Ctrl/⌘ . 切换不同的聊天模式。

由于支持的模型具有更大的上下文窗口，长上下文聊天允许你将整个文件夹作为上下文。点击[这里](https://docs.cursor.com/advanced/models target=)了解更多关于长上下文专用模型的信息。

自定义

选择 AI 模型

通过[模型切换](https://docs.cursor.com/advanced/models target=)选择你喜欢的 AI 模型，Cursor Chat 将使用该模型生成回答。你可以按 Ctrl/⌘ / 切换模型。

默认情况下，Cursor Chat 使用 OpenAI 的 GPT-4（具体来说，gpt-4 标签指向我们的 GPT4-Turbo 实例）。

你为聊天选择的 AI 模型会保存到下次使用，所以你不需要每次打开 Cursor Chat 都重新选择。

在编辑器中使用

点击横向的"更多"按钮，然后点击"在编辑器中打开聊天"，可以将 Cursor Chat 作为编辑器标签页使用。这样 Cursor Chat 就会像普通编辑器标签页一样工作。按 Ctrl/⌘ + L 会打开聊天标签页并聚焦到它。

设置

你可以在 Cursor 设置 > 功能 > 聊天 中自定义 Cursor Chat。

这些设置包括：

始终搜索网络答案
这会让 AI 模型在每次查询时浏览网络以获取最新信息。
添加聊天淡入动画
这会为 AI 消息生成时添加平滑的动画效果。
默认无上下文
这会让 AI 模型只使用用户消息作为上下文，不包含当前文件等额外上下文。
自动滚动聊天
当位于线程底部时，这会随着 AI 生成文本自动滚动聊天。
聊天面板窄滚动条
开始新聊天时显示聊天历史

代码库集成

默认代码库聊天

如果代码库没有索引，Cursor Chat 会先尝试计算一些搜索查询来搜索你的代码库。为了获得更好的准确性，建议使用[嵌入式搜索](https://docs.cursor.com/chat/codebase target=)。

嵌入式搜索

通过代码库索引，Cursor Chat 可以根据你的代码库准确生成回答。

输入消息后按 Ctrl/⌘ + Enter，Cursor Chat 会扫描你的索引代码库以找到相关代码片段。这通常适用于快速包含要纳入对话上下文的代码片段。要更好地控制代码库搜索并提高准确性，可以使用 @codebase。

高级代码库搜索

使用 @Codebase 时，Cursor 代码库聊天会进行更详细的搜索。

点击这里了解更多关于 @Codebase 的信息。

应用

Cursor 的 应用 功能让你可以快速将聊天中的代码块建议集成到你的代码中。

应用代码块

要应用代码块建议，你可以点击每个聊天代码块右上角的播放按钮。

这会编辑你的文件以合并聊天生成的代码。由于你可以在聊天中添加最多的上下文并与模型进行最多的来回交互，我们建议对更复杂的 AI 驱动代码更改使用聊天 + 应用。

接受或拒绝

应用代码块后，你可以查看差异并接受或拒绝更改。你也可以点击聊天代码块右上角的"接受"或"拒绝"按钮。

按 Ctrl/⌘ Enter 接受，按 Ctrl/⌘ Backspace 拒绝。

Cmd K

概述

Cmd K（在 Windows/Linux 上是 Ctrl K）让你能够在编辑器窗口中生成新代码或编辑现有代码。

提示栏

在 Cursor 中，按下 Ctrl/Cmd K 时出现的栏称为"提示栏"。它的工作方式类似于聊天的 AI 输入框，你可以正常输入文字，或使用 @ 符号来引用其他上下文。

内联生成

如果在按下 Ctrl/Cmd K 时没有选择任何代码，Cursor 将根据你在提示栏中输入的内容生成新代码。

内联编辑

要进行就地编辑，只需选择要编辑的代码，然后在提示栏中输入指令即可。

后续指令

每次生成后，你可以在提示栏中添加更多指令来进一步完善，按下 Enter 键后 AI 会根据你的后续指令重新生成。

默认上下文

除了你手动添加的 @ 符号外，Cursor 默认会尝试找到各种有用的信息来改进代码生成。

额外的上下文可能包括相关文件、最近查看的文件等。收集后，Cursor 会根据与你的编辑/生成的相关性对上下文项进行排序，并将最相关的项保留在大语言模型的上下文中。

快速提问

在提示栏中按下 Option/Alt Enter，Cursor 将回答你关于所选内容和你附加的上下文的任何问题。

这个对话的内容可以在后续生成中继续使用，所以当 Cursor 给出回答后，你只需输入"执行"就可以生成代码。

终端 Cmd K

在 Cursor 内置终端中，按下 Ctrl/⌘ K 会在终端底部打开一个提示栏。你可以在这个提示栏中描述想要在终端中执行的操作，终端 Cmd K 将生成相应的命令。按 esc 可以接受命令，或按 Ctrl/⌘ + Enter 立即运行命令。

默认情况下，终端 Cmd K 会将你的最近终端历史记录、指令以及提示栏中的其他内容作为上下文。

上下文

代码库索引

为代码库建立索引

为了通过 @codebase 或 Ctrl/⌘ Enter 获得更好、更准确的代码库答案，你可以为代码库建立索引。在后台，Cursor 会为代码库中的每个文件计算嵌入向量，并用这些向量来提高代码库答案的准确性。

你的代码库索引会自动与最新的代码库变更保持同步。

你可以在 Cursor 设置 > 功能 > 代码库索引 下查看索引状态。

高级设置

默认情况下，Cursor 会索引代码库中的所有文件。

你可以展开 显示设置 部分来访问更多高级选项。在这里，除了 .gitignore 设置外，你还可以决定是否为新仓库启用自动索引，以及配置 Cursor 在仓库索引过程中要忽略的文件。

如果你的项目中有一些 AI 完全不需要读取的大型内容文件，忽略这些文件可以提高答案的准确性。

AI 规则

你可以通过修改 Cursor 设置 > 通用 > AI 规则 来添加自定义指令。

这些自定义指令将在使用 Cursor 聊天和 Ctrl/⌘ K 等功能时生效。

`.cursorrules` 文件

如果你需要设置针对特定项目的指令，可以在项目根目录下创建一个 .cursorrules 文件。

和"AI 规则"设置一样，.cursorrules 文件中的指令也会在使用 Cursor 聊天和 Ctrl/⌘ K 等功能时生效。

@Symbols

基本用法

在 Cursor 的 AI 输入框中（如 Cmd K、聊天或终端 Cmd K），你可以通过输入 @ 来使用 @ 符号功能。此时会弹出一个建议列表，系统会根据你的输入自动筛选出最相关的建议。

键盘快捷键

你可以使用上下方向键浏览建议列表，按 Enter 键选择建议。如果选中的是类别（比如"文件"），系统会将建议过滤为该类别中最相关的项目。

Cmd K 快捷键

你可以使用上下方向键浏览已选择的 Cmd K @ 符号列表，按 Enter 键展开或折叠所选的上下文项。对于文件引用，你可以使用 Ctrl/⌘ M 来切换文件读取策略。点击[这里](https://docs.cursor.com/context/@-symbols/@-files target=)了解更多关于文件读取策略的信息。

@Files

`@Files`

在 Cursor 聊天和 Cmd K 等 AI 输入框中，你可以使用 @Files 来引用整个文件。另外，在输入 @ 后继续输入时，你会在 @Code 策略后看到文件搜索结果。

为了确保你引用的是正确的文件，Cursor 会显示文件路径的预览。当你在不同文件夹中有多个同名文件时，这个功能特别有用。

聊天中的长文件引用

在 Cursor 聊天中，如果文件内容太长，Cursor 会将文件分成小块，并根据与查询的相关性重新排序。

Cmd K 分块策略

对于 Cmd K，Cursor 也会根据文件内容长度采用不同的引用方式。

自动
根据文件大小自动选择三种读取策略之一
完整文件
使用整个文件作为上下文
大纲
Cursor 解析文件的大纲并将信息用作上下文
分块
Cursor 将文件分成小块并选择最相关的部分

拖放功能

你也可以从主侧边栏将文件拖放到聊天或 Cmd K 中，将它们添加为上下文。

@Folders

目前， **@Folders**功能仅在 Cursor 聊天中可用。

`@Folders`

你可以在 Cursor 中将整个文件夹作为上下文引用。当你需要向 AI 提供大量上下文信息时， **@Folders**功能特别有用，可以在[长上下文聊天](https://docs.cursor.com/chat/overview target=)中发挥作用。

@Code

`@Code`

你可以使用 @Code 符号来引用特定的代码段。

代码预览

与 @Files 符号类似，Cursor 会显示代码内容的预览，以便你确认引用的是正确的代码。

从编辑器中引用

添加代码片段作为上下文的另一种方式是选择要引用的代码，然后点击"添加到聊天"（Ctrl/⌘ Shift L）或"添加到编辑"（Ctrl/⌘ Shift K）。

这些操作会将选中的代码片段添加到聊天输入框或当前活动的 Cmd K 提示栏中。

要将选中的代码添加到新的聊天中，你可以按 Ctrl/⌘ L。

@Docs

`@Docs`

Cursor 内置了一系列已经爬取和索引的第三方文档，可以直接用作上下文。你可以使用 @Docs 符号来访问这些文档。

添加自定义文档

如果你想爬取和索引其他未提供的文档，可以通过 @Docs > Add new doc（添加新文档）来实现。粘贴你想要的文档URL后，会出现以下窗口：

然后 Cursor 会对文档进行索引和学习，之后你就可以像使用其他文档一样将其作为上下文。

管理自定义文档

在 Cursor 设置 > 功能 > 文档 下，你可以看到已添加的文档。你可以在这里编辑、删除或添加新文档。

@Git

目前，@Git 功能仅在 Cursor 聊天中可用。

`@Git`

在 Cursor 聊天中，你可以使用 @Git 来将 git 提交记录、代码差异或合并请求添加到你的对话中。

常见用法

@Git 的一个常见用途是让 Cursor 的 AI 扫描代码差异，查找可能由这些更改引起的漏洞或问题。

你还可以使用 @Diff of Working State（工作区差异）来根据当前的代码更改自动生成提交信息。

@Codebase

`@Codebase`

通过 @Codebase，Cursor 聊天会按以下步骤查找最重要的代码片段：

收集：扫描代码库中的重要文件和代码片段
重排序：根据与查询的相关性对内容进行重新排序
分析：思考如何使用上下文内容
生成：提供回应

提交高级代码库查询的另一种方式是点击 Ctrl/⌘ + Enter 按钮旁边的下拉菜单，选择 reranker（重排序）作为搜索方式。注意，这个功能只在不使用 @Codebase 时可用，因为 @Codebase 具有优先权。

@Web

`@Web`

使用 @Web 时，Cursor 会根据你提供的查询和上下文构建搜索请求，并在网上搜索相关信息作为额外的参考。这对于获取最新信息特别有用。

始终开启

你可以通过在 Cursor 设置 > 功能 > 聊天 中开启"始终搜索网络"选项，让 Cursor 在每次查询时都搜索网络。这相当于在每次查询时都使用 @web。

@Chat

此功能目前仅在 Cmd K 中可用。

`@Chat`

你可以在 Cmd K 中使用 @Chat 将当前的聊天记录添加为上下文。当你想要将与 AI 的对话内容应用到代码编辑或生成中时，这个功能特别有用。

@Definitions（定义）

此功能目前仅在 Cmd K 中可用。

`@Definitions`

@Definitions 符号可以将附近的所有定义添加到 Cmd K 作为上下文。

粘贴链接

@https://你的链接.com

如果你希望 Cursor 在回应前访问某个链接，只需输入 @ 符号，然后粘贴链接即可。

移除链接

默认情况下，Cursor 聊天会自动解析链接并将其转换为 @Links 格式。如果你想将链接显示为纯文本，只需点击链接，然后点击 取消链接 选项。

忽略文件

要在 Cursor 功能（如代码库索引）中忽略某些文件，你可以在项目根目录下创建一个 .cursorignore 文件。它的工作原理和 git 的 .gitignore 一样。

.cursorignore 会遵循 .gitignore 的设置。如果你已经有 .gitignore 文件，这些文件会被默认忽略。如果你想忽略额外的文件，可以把它们添加到 .cursorignore 文件中。

示例 `.cursorignore` 文件

忽略特定文件

# Ignore all files in the `dist` directory
dist/

# Ignore all `.log` files
*.log

# Ignore specific file `config.json`
config.json

只包含特定文件

仅包含 app 目录中的 *.py 文件。注意，这里使用的语法与 .gitignore 相同。

# ignore everything
*
# do not ignore app
!app/
# do not ignore directories inside app
!app/*/
!app/**/*/
# don't ignore python files
!*.py

常见问题

忽略文件的语法有时会让人感到困惑。.cursorignore 文件使用的语法与 .gitignore 完全相同。如果你在使用忽略文件时遇到问题，建议在 Google 搜索时将 cursorignore 替换为 gitignore。很可能有人遇到过相同的问题，并在 StackOverflow 上找到了好的解决方案。

一个常见的例子：这里介绍了如何忽略除了 .php 扩展名以外的所有文件（仅添加 * 然后添加 !*.php 是不够的，因为文件忽略器不会深入子目录去查找 .php 文件）。

Advanced（高级功能）

模型选择

在 Cursor 聊天、Ctrl/⌘ K 和终端 Ctrl/⌘ K 中，你可以轻松切换不同的 AI 模型。

模型下拉菜单

在 AI 输入框下方，你会看到一个下拉菜单，可以选择想要使用的模型。Cursor 默认提供以下模型：

GPT-4o
GPT-4
Claude 3.5 Sonnet
cursor-small
cursor-small 是 Cursor 自己的模型，虽然不如 GPT-4 智能，但速度更快，而且用户可以无限制使用。

你可以在 Cursor 设置 > 模型 > 模型名称 中添加其他模型。

长上下文模型

在长上下文聊天中，只能选择支持长上下文的模型：

gpt-4o-128k
gemini-1.5-flash-500k
claude-3-haiku-200k
claude-3-sonnet-200k
claude-3-5-sonnet-200k

各模型的上下文窗口大小

在普通聊天中，我们目前限制在约 20,000 个标记（如果模型不支持这么多，则会更少）。对于 cmd-K，我们限制在约 10,000 个标记，以平衡响应速度和质量。长上下文聊天则会使用模型支持的最大上下文窗口。

自定义 API 密钥

OpenAI API 密钥

Cursor 允许你使用自己的 OpenAI API 密钥，这样你就可以按照自己的费用发送任意数量的 AI 消息。

你可以从这里获取自己的 API 密钥。要使用自己的 API 密钥，请进入 Cursor 设置 > 模型 > OpenAI API 密钥，输入你的 API 密钥。然后点击"验证"按钮。一旦密钥验证通过，你的 OpenAI API 密钥就会被启用。

Anthropic API 密钥

和 OpenAI 类似，你也可以设置自己的 Anthropic API 密钥，这样就可以按照自己的费用使用基于 Claude 的模型。

Google API 密钥

对于 Google API 密钥，你可以设置自己的 API 密钥，这样就可以按照自己的费用使用 Google 的模型，比如 gemini-1.5-flash-500k。

Azure 集成

最后，你还可以设置自己的 Azure API 密钥，这样就可以按照自己的费用使用 Azure OpenAI 模型。

我的 API 密钥会被存储或离开我的设备吗？

你的 API 密钥不会被存储，但每次请求时都会被发送到我们的服务器。所有请求都会通过我们的后端处理，因为最终的提示构建是在那里完成的。

AI 代码审查（测试版）

AI 代码审查是一个功能，可以帮助你检查代码库中的最近更改，及时发现潜在的问题。

你可以点击单个审查项目，在编辑器中查看完整上下文，并与 AI 聊天以获取更多信息。

自定义审查指令

为了让 AI 代码审查更好地满足你的需求，你可以提供自定义指令让 AI 关注特定方面。比如，如果你想让 AI 关注代码性能问题，可以这样写：

关注代码性能

这样，AI 在检查你的代码更改时就会特别关注性能相关的问题。

审查选项

目前提供以下几种审查选项：

审查工作区
检查你未提交的更改。
与主分支对比审查
检查当前工作区与主分支之间的差异。
审查最近提交
检查你最近一次的代码提交。

Shadow 工作区

Shadow 工作区是一个可选设置，你可以开启它来提升 AI 生成代码的质量。目前只有部分功能会使用到这个特性。

当你启用 Shadow 工作区后，后台 AI 可以对它们写的代码进行代码检查。这个过程会在你的电脑本地创建一个隐藏窗口，不会影响你的正常编码体验。

由于 Shadow 工作区会增加 Cursor 的内存使用量，我们建议只有在你的电脑内存充足的情况下才开启这个功能。

你可以在我们的博客文章中了解更多关于 Shadow 工作区的信息。

隐私常见问题

什么是隐私模式？

启用**隐私模式**后，我们和任何第三方都不会存储你的代码。否则，我们可能会收集提示、代码片段和使用数据来改进 Cursor。你可以在这里了解更多关于隐私模式的信息。

你可以在初始设置时或通过 Cursor 设置 > 通用 > **隐私模式**来启用隐私模式。

请求是否总是通过 Cursor 后端处理？

是的！即使你使用自己的 API 密钥，你的请求仍然会通过我们的后端！因为我们需要在后端完成最终的提示构建。

索引代码库是否需要存储代码？

不需要！如果你选择索引代码库，Cursor 会将你的代码库分成小块上传到我们的服务器来计算嵌入向量，但所有明文代码在请求结束后就会被删除。

我们的数据库只会存储代码库的嵌入向量和元数据（哈希值、模糊化的文件名），而不会存储你的任何代码。

你可以在我们的安全页面了解更多信息。

问题排查

常见问题

我看到更新日志有新版本，但 Cursor 不更新

如果更新很新，可能还没有推送到你这里。我们采用分阶段推送策略，即先向随机选择的一部分用户推送新更新，然后再推送给所有用户。通常从第一个用户开始，大约需要 5 小时才能覆盖所有用户。对于较大的更新，可能需要更长时间。

我的 GitHub 登录有问题/如何在 Cursor 中退出 GitHub？

你可以在命令面板中使用 Sign Out of GitHub 命令（快捷键 Ctrl/⌘ + Shift + P）。

我无法使用 GitHub Codespaces

很抱歉，我们目前还不支持 GitHub Codespaces。

我连接远程 SSH 时出错

目前我们不支持 SSH 连接到 Mac 或 Windows 机器。如果你使用的不是 Mac 或 Windows 机器，请在论坛上向我们报告问题。提供一些日志信息会帮助我们更好地协助你。

在公司代理后面无法使用 Cursor Tab 和 Cmd K

Cursor Tab 和 Cmd K 默认使用 HTTP/2，这样可以用更少的资源获得更低的延迟。但某些公司代理（例如某些配置下的 Zscaler）会阻止 HTTP/2。要解决这个问题，你可以在设置中将 "cursor.general.disableHttp2" 设为 true（按 Cmd/Ctrl + , 然后搜索 http2）。