Cursor Composer 简介 - AI 编码助手功能与使用指南

开发者的 Composer 指南

欢迎使用 Composer

Composer 是您在编辑器中的 AI 编码助手。它帮助您探索代码、编写新功能并修改现有代码，而无需离开您的工作流程。使用 ​⌘I​ 打开它，使用 ​⌘N​ 创建一个新的 Composer。

代理

使用 ​⌘.​ 启用代理，以获得一个主动与您的代码库协作的编码伙伴：

• 自动提取相关上下文（尝试 ​@Recommended​）
• 运行终端命令
• 创建和修改文件
• 语义搜索代码
• 执行文件操作

代理在停止之前最多可以进行 25 次工具调用。如果您需要更多，请通过 hi@cursor.com 告诉我们！

目前，代理仅支持 Claude 模型。

每个工具操作都计为您配额中的一个单独请求。

​

正常

正常模式提供代码探索和生成的核心功能：

• 在您的代码库和文档中搜索
• 使用网络搜索
• 创建和编写文件
• 访问扩展的 ​@-​符号命令

使用上下文

输入 ​@​ 以查看基于您当前工作的上下文选项。使用箭头键导航，按 Enter 选择，并在 ​@​ 后输入以进行过滤。使用 ​Ctrl/⌘ M​ 切换文件读取方法。代理中的 ​@Recommended​ 会自动提取相关上下文。

​#​ 文件选择

使用 ​#​ 后跟文件名以专注于特定文件。将其与 ​@​ 符号结合使用以实现精确的上下文控制。

上下文药丸聊天顶部的药丸显示活动上下文。添加或删除药丸以调整 Composer 看到的内容。使用 ​#​ 选择文件，这些文件将作为药丸出现。

生成和应用更改

当 Composer 建议更改时：

• 在差异视图中查看它们
• 使用提供的按钮接受或拒绝更改
• 使用检查点在需要时撤销

检查点

每次生成代码时，Composer 会创建一个检查点。您可以通过单击该检查点附近的 ​checkout​ 返回到任何先前版本。如果您不喜欢当前更改并希望恢复到早期状态，这非常方便。

历史记录

通过历史记录访问以前的 Composer 会话和聊天。从 Cursor 标签右侧的历史图标打开它。您将看到过去的 Composer 和聊天列表，您可以重新访问、重命名或删除。

当 Composer 聚焦时，使用 ​⌘+⌥+L​ 或 ​Ctrl+Alt+L​ 打开。

布局

Composer 提供两种布局模式：

• 窗格：左侧为聊天，右侧为代码编辑器的侧边栏。
• 编辑器：单个编辑器窗口，类似于正常查看代码。您可以移动它、拆分它，甚至将其放置在单独的窗口中。

测试版功能

迭代修复代码风格问题

Composer 尝试修复大多数编程语言生成代码中的代码风格问题。如果 Composer 检测到代码风格错误，当此功能启用时，它将尝试自动修复它们。目前，仅支持一次迭代。

某些语言（如 Rust）要求在出现代码风格错误之前保存文件，这可能会限制此功能在所有语言中的有效性。

常见问题解答

聊天和 Composer 之间有什么区别？

Cursor 聊天帮助您搜索和理解代码。使用它来探索您的代码库、提出问题并获取解释。您可以使用 ​⌘⏎​ 搜索代码。

Composer 帮助您编写和编辑代码。它提供一个工作区，您可以在其中生成新代码并直接将更改应用到文件中。