Cursor中文使用手册

Cursor中⽂使基本⽤@在Cursor的输⼊框中，例如在CmdK、聊天或终端CmdK中，您可以通过输⼊来使⽤@符号 @您可以使⽤向上/向下箭头键浏览建议列表。您可以点

选择建议。如果建议是⼀个类别 ，则建议将被过滤以仅显⽰该类别中最相关的项⽬Composer是编辑器中的AI编码助⼿。它可以帮助您探索代码、编写新功能和修改离开⼯作流程。使

打开它，

创建新Composer代理模式启⽤代理 获取主动使⽤您的代码库的编码合作伙伴⾃动提取相关上下⽂（尝 运⾏终端命创建和修改⽂按语义执⾏⽂件操代理在停⽌前最多可以进⾏25次⼯具调⽤⽬前，Agent仅⽀Claude正常模式正常模式为代码探索和⽣成提供了核⼼功搜索您的代码库和⽂使⽤⽹⻚@创建和写⼊⽂@访问扩

-symbol命使⽤上下⽂Ctrl/⌘键⼊@以查看基于您当前⼯作的上下⽂选项。使⽤箭头键导航，使⽤Enter选择，然后键⼊Ctrl/⌘@。使

切换⽂件读取⽅

代理会⾃动提取相关上下⽂##@⽂##@使

后跟⽂件名来关注特定⽂件。将

符号结合可实现精确的上下⽂控制上下⽂药#聊天顶部的药丸显⽰活动上下⽂。添加或删除药丸以调整Composer所看到的内容。使⽤#⽣成并应⽤变更当Composer建议更改时在差异视图中查看它使⽤提供的按钮接受或拒绝更如果需要，使⽤

选择检查点每次⽣成代码时，Composer都会创建⼀个检查点。您可以通过单

返回任何先前版本。如果您不喜欢当前的更改并希望恢复到较早的状态，这⾮常⽅历史通过历史记录访问以前的作曲家会话和聊天。从“选项卡”右侧的历史记录图标打开它。您将看到前的作曲家和聊天列表，您可以重新访问、重命名或删除它们。当Composer获得焦点时，使⽤或打布局Composer提供两种布局模式窗格：侧边栏，左侧是聊天，右侧是代码编编辑器：单个编辑器窗⼝，类似于正常查看代码。您可以移动它、拆分它，甚⾄将其放⼝中lintComposer会尝试修复⼤多数编程语⾔⽣成的代码中lint问题。如Composer检测到lint错误，某些语⾔（如Rust）要求在出现lint错误之前保存⽂件，这可能会限制此功能在所有语⾔中的有效常ChatComposerCursorChat可帮助您搜索和理解代码。使⽤它来探索代码库、提出问题并获得解释。您可以使⽤索代 Composer可帮助您编写和编辑代码。它提供了⼀个⼯作区，您可以在其中⽣成新代码并将更改直接⽤⼾消息包含您输⼊的⽂本以及您引⽤的上下⽂。您可以返回任何先前的⽤⼾消息来编辑并重新运查询。这将覆盖之后的所有消息并重新⽣成新消息。AI消息是从AI模型⽣成的响应。它们与之前的⽤⼾消息配对。AI消息可能包含已解析的代码所有⽤⼾/AI消息在同⼀个线程中称为聊天线程，每个聊天线程都保存在您的聊天历史记录中Chat（对话聊点击AI⾯板右上⻆的“上⼀个聊天”按钮，或者

，即可查Ctrl/⌘+Alt/Option+记录。您可以点击任何聊天主题返回并查看组成该Ctrl/⌘+Alt/Option+者将⿏标悬停在历史记录中的主题上，点击垃圾桶图标删除主Cursor线程的标题只是第⼀条⽤⼾消息的前⼏个字默认默认情况下，CursorChat将当前⽂件作为上下⽂。您可以通过从消息中删除当前⽂件胶囊来提交⽽不包含任何上下⽂。输⼊时，您可以在输⼊框上⽅的胶囊中看到上下⽂中将包含哪些内容添加默认情况下，⽤⼾消息将包含您输⼊的⽂本以及您引⽤的上下⽂。您可以使⽤@符号向每个⽓泡添加请参阅@符号⻚⾯以了解更多聊天中AI修复代码库中的linter错误的⼀个便捷功能是使⽤聊天中的AI修复。为此，请将⿏标悬停在编辑器中的错误上，然后单击显⽰的蓝⾊AI修复按钮。Ctrl/⌘+Shift+Ctrl/⌘+Shift+使⽤默认代码库聊如果代码库未编⼊索引，CursorChat将⾸先尝试计算⼀些搜索查询，⽤于搜索您的代码库。为了获得嵌⼊Ctrl/⌘+通过代码库索引，CursorChat可Ctrl/⌘+在输⼊消息后按

，CursorChat会扫描索引的代码库以查找相关代码⽚段通常适⽤于快速将代码⽚段纳⼊对话上下⽂中。为了更好地控制代码库搜索并获得更⾼的准可以使 ⾼级代码库代码库聊天在使⽤时会经过更详细应⽤应⽤要应⽤代码块建议，您可以按下每个聊天代码块右上⻆的播放按钮这将编辑您的⽂件以整合Chat⽣成的代码。由于您可以在Chat中添加最多的上下⽂并与模型进⾏最多的来回交流，因此我们建议使⽤Chat+Apply来进⾏更复AI驱动的代码更改。接受或Ctrl/⌘Ctrl/⌘接Ctrl/⌘Ctrl/⌘CmdCmdK（Windows/Linux上也称为“CtrlK”）允许您在编辑器窗⼝中⽣成新代码或编辑现有代提⽰Ctrl/Cmd在Cursor中，我们把按下时出Ctrl/Cmd

“提⽰栏”。它的作⽤类似于聊天的AI输框，你可以在其中正常输⼊，或者使⽤@符号引⽤其他上下⽂Ctrl/Cmd如果按下Ctrl/Cmd

，Cursor将根据您在提⽰栏中输⼊的提⽰⽣成新⾏内对于就地编辑，您只需选择要编辑的代码并输⼊提⽰栏中即可后续指每次⽣成之后，您可以通过在提⽰栏中添加更多指令来进⼀步细化提⽰，然后按据您的后续指令进⾏再⽣。

AI默认默认情况下，除了您包含的⼿动@符号之外，Cursor还会尝试查找不同类型的有⽤信息来改进代码⽣其他上下⽂可能包括相关⽂件、最近查看的⽂件等。收集后，Cursor会根据与您的编辑/⽣成的相关性Option/AltOption/Alt

在提⽰栏中按下，Cursor将回答您有关选择以及附加的上下⽂的任何这次对话的内容可以进⼀步⽤于后续的⽣成，因此您只需在Cursor给出答案后输⼊“doit”即可在快终端命令了解如Cursor终端中使⽤CmdK进⾏AI命令Ctrl/⌘在内置的Cursor终端中，你Ctrl/⌘

来在终端底部打开⼀个提⽰栏。这个提⽰栏允在终端中描述你想要的操作，终端CmdK会⽣成⼀个命令。你可以点击来接受命

或者使Ctrl/⌘+⽴Ctrl/⌘+默认情况下，终端CmdK会将您最近的终端历史记录、您的指令以及您在提⽰栏中输⼊的任何其他内代码库索引您的代码为了获得更好、更准确的代码库答案，您可以使

或

Ctrl/⌘Ctrl/⌘库。在后台，Cursor会计算代码库中每个⽂件的嵌⼊，并将使⽤这些来提⾼代码库答案的准CursorCodebase您的代码库索引将⾃动与您的最新代码CursorCodebase您的代码库索引状态

⾼Show默认情况下，Cursor将索引代码库中的所有Show您还可以展开

部分以访问更多⾼级选项。在这⾥，除了.gitignore设置之外还可以决定是否要为新存储库启⽤⾃动索引，并配置Cursor在存储库索引期间将忽略的⽂如果您的项⽬中有任何AI绝对不需要读取的⼤型内容⽂件，那么忽略这些⽂件可以提⾼答案的准确⼈⼯智能规此⾃定义指令将包含在诸如Cursor聊天和Ctrl/⌘K等功能中对于特定于项⽬的说明，您可以将说明包含 项⽬根⽬录中的⽂件中与“AI规则”部分相同 ⽂件中的说明将包含Cursor聊天和Ctrl/⌘K等功能@⽤基本⽤CursorAI输⼊框中，例如CmdK、聊天或终端CmdK中，您可以通过输⼊来使⽤@@。将出现⼀个弹出菜单，其中包含建议列表，它将根据您的输⼊⾃动过滤以仅显⽰最相关的建@您可以使⽤向上/向下箭头键浏览建议列表。您可以点

选择建议。如果建议是⼀个类别 ，则建议将被过滤以仅显⽰该类别中最相关的项⽬CmdK您可以使⽤向上/向下箭头键浏览所CmdK@符号列表

以展开/折叠所选上下⽂项。对Ctrl/⌘⽂件引⽤，您可以使⽤ 来切换⽂Ctrl/⌘AI输⼊框（例如CursorChat和CmdK）中，您可以使⽤引⽤整个⽂

。此外，如@在之后继续输 ，您将看到策略之后的⽂件搜索结 @为了确保您引⽤的⽂件是正确的⽂件，Cursor将显⽰⽂件路径的预览。当您在不同⽂件夹中有多个同您还可以引⽤Cursor中的整个⽂件夹作为上下⽂。这对于您想要向AI提供⼤量上下⽂的 尤其有⽤与符号

，Cursor将显⽰代码内容的预览，以便您可以验证所引⽤的代码是否正编辑器中使添加代码⽚段作为上下⽂的另⼀种⽅法是选择要引⽤的代码，然后单击“添加到聊天ShiftCtrl/⌘Shift）或ShiftCtrl/⌘Shift这些会将选定的代码⽚段添加到聊天输⼊框或当前活动的CmdK提⽰Ctrl/⌘要将选定的代码添加到新聊天中，您可以Ctrl/⌘@⽂Cursor附带⼀组第三⽅⽂档，这些⽂档已抓取、编⼊索引并可⽤作上下⽂。您可以使⽤ 添加⾃定义⽂如果您想要抓取和索引尚未提供的⾃定义⽂档，您可贴所需⽂档的URL后，将出现以下模式：

>进⾏操 。Addnew然后Cursor将索引并学习该⽂档，您将能够像使⽤其他⽂档⼀样将其⽤作上下⽂。如Addnew⻚⾯和⼦⽬录，请确保在URL后⾯添加⼀个斜Cursor管理⾃定Cursor除或添加新⽂

在

>

，您将看到已添加的⽂档。您可以在此处编辑、⽬

仅⽀持聊天模式在Cursor'sChat中，您可以使 将git提交、差异或拉取请求添加到您的提⽰中常⻅⽤⼀个常⻅的⽤

是允CursorAI扫描差异并寻找可能由差异导致的错误或@DiffofWorking您还可以使⽤@DiffofWorking通

，CursorChat会执⾏这些步骤，直到找到要使⽤的最重要的代码⽚段收集：扫描代码库以查找重要⽂件/重新排序：根据与查询的相关性对上下⽂项进⾏重新排推理：思考如何⽣成：提出回提交⾼级代码库查询的另⼀种⽅法是单击按钮旁边的下Ctrl/⌘+Enter并搜索⾏为。这仅

未使⽤时可⽤，否则@Codebase优先使加上下⽂

，Cursor会根据您提供的查询和上下⽂构建搜索查询，并搜索⽹络以查找相关信息作为这有助于Cursor在线找到最新的信息，或者让Cursor在⼏秒钟内抓取多个⽹站来找到最佳答案，⽆需⽤⼾⼿动搜索任何地⽅@聊此功能⽬前仅适⽤于CmdK您可以使

CmdK内部的命令添加当前聊天消息作为上下⽂。当您与想要编辑或⽣成AI进⾏对话时，此功能很有⽤此功能⽬前仅适⽤于CmdK该

符号将所有附近的定义添加到CmdK作为上下⽂@为了让Cursor在响应之前访问链接，请@

然后粘贴该链默认情况下，我们会⾃动解析链接并将其

为CursorChat。如果您希望将链接转换⽂本，请单击链接，然后单 Cursor设置可让您根据⾃⼰的喜好配置。通过

Cursor>访Cursor常导⼊VSCode设置为AI编写⾃⼰的规则配置编辑器设置管理您的隐私设置模模型下在AI输⼊框下⽅，您将看到⼀个下拉菜单，让您选择要使⽤的模型。默认情况下，Cursor提供这些模如果您想使⽤受⽀持的提供商提供的模型但未在此设置部分中看到它，此功能尤其有⽤。请注意，果启⽤，您将以公共LLMAPI费⽤使⽤usor，但须遵守您特定帐⼾的使⽤限制。特Peek中您还可以在“转到定义”或“转到类型定义”预览视图中使⽤“光标选项卡”。这很有⽤，例如向函数调⽤添加新参数时。我们特别喜欢在vim中结合使

，例如，修改函数定义，然后⼀次性修复其所有⽤Cursor还可以预测您在编辑被接受后将转到的位置。如果可⽤，您将能够按Tab键转到下⼀个位置，从⽽允Tab-Tab-Tab键浏览编辑。Cursor预测了下⼀个位置，并建议在那⾥进⾏编Ctrl/⌘您可以通过按右箭头（或设置为您喜欢的键绑定）来接受建议的下⼀个CursorCursorCursorCursor要启⽤部分接受，请导

Chat&Agent如果启⽤，您在正常模式和代理模式之间的选择将在新的Composer对话中持续存⾃动滚动⾄底当⽣成新消息时⾃动滚动到编写器窗格的底⾃动应⽤于上下⽂之外的⽂允许Composer⾃动将更改应⽤于当前上下⽂之外的⽂在窗格或编辑器中折叠输⼊折叠编辑器窗格或编辑器输⼊框中的pills以节省渲染为药丸⽽⾮将Composer代码块折叠成“pills”，⽽不是将其渲染为Lints[测试版Notepads[测试版代码库默认索引新⽂启⽤后，新⽂件将默认⾃动编⼊索引。如果禁⽤，您仍可以通过按“计算索引”按钮来索引⽂件夹仅对⽂件少于10,000个的⽂件夹⾃动⽣成索引忽略⽂ Git图表关启⽤后，Cursor将索引您的git历史记录以了解⽂件之间的关代码和提交消息存储在本地，⽽有关提交的元数据（SHA、更改次数和模糊⽂件名）则存储在云端⽂在这⾥，您可以在编辑器中配置和管理⽂编在这⾥，