Cursor注册下载登录使用一条🐉

Cursor注册下载登录使用一条🐉

完成人：博客园-岁月月宝贝

搬运权限：评论区联系作者取得同意方可

首先，先为大家提供一些特别好的链接(😊别人的链接)：

• 是最详细的安装配置指南： 【Cursor】合理安装配置Cursor 纵享丝滑 - 知乎

• 注册+使用方法(尤其Composer的快捷键)+无限续杯方法： Cursor 全攻略：注册、使用到无限续杯，一次性讲清楚 - 知乎

• 超详细的@使用方法+composer使用方法：Cursor安装教程（2025年最新Cursor使用教程） - 知乎

• 本来不准备介绍但是是官方的，也有“纵向丝滑“里面的VS Code 迁移：安装 | Cursor文档-Cursor中文文档-Cursor AI文档

• Cursor两种使用方式对比：用Cursor 来提升你的开发效率_vscode cursor-CSDN博客

• 🐂（疑似包含前面介绍过的全部的使用方法，长文警告！）Cursor使用教程_cursor退出登录-CSDN博客

• VScode 插件推荐（cursor通用）：VScode 插件推荐（cursor通用）_vscode cursor插件-CSDN博客

• Cursor官方网页： Sign in

目录

• 注册+下载+基本配置
• 限制了解
  • 🌳订阅层级
• 功能熟悉
  • 🌳Tab
    • 🍃 补全部分&差异窗口
    • 🍃 相较于GitHub Copilot的改进
    • 🍃 高级功能
  • 🌳Composer
    • 🍃 核心功能
    • 🍃 布局
  • 🌳chat
    • 🍃 聊天框消息覆盖功能
    • 🍃 聊天历史查找功能
    • 🍃 默认上下文
    • 🍃 聊天中的AI修复
    • 🍃 模型自定义
    • 🍃 带代码库
      • 🌱 代码库未被索引
      • 🌱 代码库索引
  • 🌳Ctrl+K
    • 🍃编辑器内
    • 🍃 终端内
  • 🌳context上下文
    • 🍃 代码库索引
    • 🍃 Cursor 人工智能规则
    • 🍃 项目规则（推荐）
      • 🌱 .cursorrules
    • 🍃 忽略文件
      • 🌱 示例
    • 🍃 基本用法
      • 🌱 键盘快捷键&Cmd K 键盘快捷键
    • 🍃 @Files
      • 🌱 聊天长文件引用
      • 🌱 Ctrl K分块策略
      • 🌱 拖放
    • 🍃 @Folder
    • 🍃 @Code
    • 🍃 @Docs
      • 🌱 添加自定义文档
      • 🌱 管理自定义文档
    • 🍃 @Git
    • 🍃 @Codebase
    • 🍃 @Web
    • 🍃 @Chat
    • 🍃 @Recent changes
    • 🍃 @Definitions
    • 🍃 粘贴链接
      • 🌱 移除链接
  • 🌳settings
    • 🍃 概述
    • 🍃 模型
      • 🌱 模型下拉菜单
      • 🌱 支持的提供商
    • 🍃 功能
      • 🌱 1 Cursor标签
      • 🌱 2 聊天与创作
      • 🌱 3. 代码库索引
      • 🌱 4. 文档
      • 🌱 5.编辑器
      • 🌱 6.终端
  • 🌳billing
  • 🌳plans-business
  • 🌳features
    • 🍃 生成提交信息
      • 🌱 快捷键
    • 🍃 记事本
  • 🌳advanced
    • 🍃 模型上下文协议
    • 🍃 键盘快捷键
      • 🌱 常规
      • 🌱 聊天
      • 🌱 Composer
      • 🌱 Cmd+K
      • 🌱 代码选择和上下文
      • 🌱 Tab
      • 🌱 终端
• 常见问题
  • • 🍃 我在更新日志上看到更新，但光标不会更新。
    • 🍃 我在光标中遇到GitHub登录问题 / 如何在光标中退出GitHub？
    • 🍃 我无法使用GitHub Codespaces。
    • 🍃 我在连接远程SSH时遇到错误。
    • 🍃 光标标签和Cmd K在我的公司代理后不起作用。
    • 🍃 我刚订阅了Pro，但在应用中仍然是免费计划。
    • 🍃 我的使用情况何时会重置？
    • 🍃 我该如何卸载光标？

注册+下载+基本配置

• 首先，我们搜索到Cursor官方网页完成注册，然后登录后的页面是这样：

然后这个页面的解释是：

👆如上图，刚注册完，cursor会给新用户一个14天的免费试用期，有150次的高速模型 (Claude，openAI等顶流大模型) 调用次数

• 然后点击

• 最好下载到D盘，然后选如下选项：

哇！然后别忘了今天晚上重启！

• 然后跳出了下面这个界面：

（左边是我参考的知乎~）

• 选好后，页面自动跳转到Vscode配置加载界面！😀

• 然后好像要重启！

那我们就重启吧！

• 然后，你会惊讶地发现！我们的Vscode主题迁移过来啦！！！

• 然后，还需要点：

我们点蓝色的那个

• 下面：

• 我们默认就行😊

然后，Log in登录！

• 这边会帮你跳到浏览器，填好对应的邮箱和密码就可以转到这个界面😘

• 哇！然后到了下面的界面！

• （可以先把界面调为中文）然后，我们来调整下工作区的布局：看下面这个就OK！！！

Windows环境修改Cursor活动栏位置(具体)-CSDN博客

不用看这个也行，反正最新版的cursor里面也找不到下图

• 然后你需要像下面这样改：

先按下图操作：

然后你需要把文件改成和我一样：

⭐主要是加最后一行，然后重启cursor就行

🐱：听说还有一个通义千问插件！！！搜下！！Cursor里面的通义千问插件 - 搜索 哇！还有添加方法：Cursor接入通义千问Qwen2.5的步骤_cursor 通义千问-CSDN博客

• 哇！误入一个超好的网站！🐕学习 Cursor ，拥抱 AI 编程 | Cursor 101

咳咳，发现他的链接都用的是别人的博客😤，找到原主啦！鸟飞鱼跃 ｜ 分享个人观点，AI探索，独立开发

🐱：用cursor的模型和直接在里面填上OpenAI 的API KEY有什么区别？❤

这里讲下：

1.关于模型的选用(涉及DeepSeek v3，Gemini Flash 2.0，Claude 3.5 Sonnet)&一点点需要高智商的白P教程：关于Cursor 模型的选用及免费使用教程（包括免费白嫖GPT-4、Claude 3.5 Sonnet 等) - 知乎 🐢（有提炼出输入了自己喜欢的API key+选好了自己想选的模型，需要把其他的API key 去掉）

2.自定义模型的弊端（自动apply、Composer、Tab键等很多功能都没法用，只能使用chat方法）+如果你一定要用，应该怎么做：Cursor高频问题：是否支持自定义模型使用_ITPUB博客

限制了解

🌳订阅层级

Cursor 提供多个订阅层级以满足您的需求。（有关定价信息，请访问 Cursor Pricing。）

• 爱好者
  • 14 天 专业试用（250 次快速 premium 模型使用）
  • 50 次慢速 premium 模型使用
  • 2000 次 完成 使用
• 专业版
  • 每月 500 次快速 premium 模型使用
  • 无限次慢速 premium 模型使用
  • 无限次 完成 完成
  • 每月 10 次 o1+mini 使用
• 企业版
  • 使用信息与 专业版 相同
  • 全组织强制隐私模式
  • 集中团队计费
  • 带有使用统计的管理员仪表板
  • SAML/OIDC 单点登录

功能熟悉

为了了解最全面最完善最新的功能，我决定细读中文文档😊基本用法 | Cursor文档-Cursor中文文档-Cursor AI文档 ，还有就是那个 鸟飞鱼跃 ｜ 分享个人观点，AI探索，独立开发 这个也很全，主要是有更多真人使用的反馈，但是说到这个，上面的知乎那边也有😝

（灵光乍现：我是不是可以远程链接时用cursor? 您别说，真的有”坑“🕳+解决方案：使用 Cursor 进行远程开发 | 今天没有早睡）

啊啊啊啊啊啊啊啊啊啊,最新版完全解决了远程问题!!!!!!

🌳Tab

🏠限制了解：免费用户可以免费获得 2000 个建议。专业版和商业版计划可以获得无限建议。

🏠节省时间版：本地的自动补全功能。它是一个更强大的 Copilot，能够建议整个差异，并具有特别好的记忆。

🏠驱动：自定义模型，可以：

• 在光标周围建议编辑，而不仅仅是插入额外的代码。
• 同时修改多行。
• 根据您最近的更改和 linter 错误提出建议。

🍃 补全部分&差异窗口

当 Cursor 仅添加额外文本时，补全将以灰色文本显示。

如果建议修改现有代码，它将作为差异弹出窗口出现在您当前行的右侧。

您可以通过按 Tab 接受建议，或通过按 Esc 拒绝建议。要逐字部分接受建议(每次接受建议的下一个单词)，请按 Ctrl/⌘ →。要拒绝建议，只需继续输入，或使用 Escape 取消/隐藏建议。

部分接受打开方法

每次按键或光标移动时，Cursor 将尝试根据您最近的更改提出建议。然而，Cursor 并不总是会显示建议；有时模型预测没有需要更改的内容。

Cursor 可以对您当前行上方一行到下方两行进行更改。

🍃 相较于GitHub Copilot的改进

GitHub Copilot 可以在光标位置插入文本。但它无法编辑光标周围的代码或删除文本。

Cursor 可以在光标处插入文本，并且功能更多😍：

• 多字符编辑

• 基于指令的编辑

此外，Cursor 在上下文窗口中保留了您最近更改的历史记录😎，因此它知道您接下来要做什么。

另外，🔒默认情况下，Cursor 优先于 GitHub Copilot。

🍃 高级功能

Peek中的Tab(这个暂时看不懂，但是感觉很重要)
您还可以在“转到定义”或“转到类型定义”的peek视图中使用光标Tab。这在例如向函数调用添加新参数时非常有用。
我们特别喜欢在vim中结合使用`gd`，例如，修改函数定义，然后一次性修复其所有用法。

光标预测

光标还可以预测在接受编辑后您将去往何处。如果可用，您将能够按Tab键转到下一个位置，从而允许您通过编辑进行tab-tab-tab。

光标预测了下一个位置，并在此处建议了一项编辑。

🌳Composer

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

它的功能：

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

🏠限制了解：代理在停止之前最多可以进行 25 次工具调用。每个工具操作都计为您配额中的一个单独请求。如果您需要更多，请通过 hi@cursor.com 告诉我们！

🏠Agent: 目前，仅支持 Claude 模型。

🍃 核心功能

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

@的使用

#文件选择

上下文cell(感觉有点抽象，感觉是上下文对话框？)

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

不确定是不是指的这个

检查点(感觉是有的，但是我没找到，可以因为我前面依赖git多些？)

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

历史记录

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

当 Composer 聚焦时，使用 ⌘+⌥+L 或 Ctrl+Alt+L 打开（这两个键都找不到嘿，传说若打开有下图）。

🍃 布局

Composer 提供两种布局模式：

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

窗格：

编辑器：

先选这个

然后，你会发现我们的编辑器框既可以：

又可以像下面这样：

是不是很神奇，单拉开了一个窗口

（惊奇发现，下面还有”Past chats“表示过去的会话！）

🌳chat

通过按 Ctrl/⌘ + L 打开聊天。提交您的查询，请按 Enter。

🍃 聊天框消息覆盖功能

• 用户消息：您输入的文本，以及您引用的上下文。

您可以返回到先前任何一个用户消息进行编辑并重新运行查询。这将覆盖之后的所有消息并生成新的消息。

• AI消息：您选择的 AI 模型生成的响应。

它们与之前的用户消息配对。AI 消息可能包含解析的代码块，可以通过 即时应用 添加到您的代码库中。

👾：”即时应用“大概是说，即使你先在与AI的对话中点击了”Apply“,

仍然可以查看差异并接受或拒绝更改：

例如，点击聊天代码块右上角的“接受”或“拒绝”按钮

（但是图中的东西未尝试！）

🍃 聊天历史查找功能

通过点击 AI 面板右上角的“先前聊天”按钮，您可以查看聊天历史。您可以点击任何聊天线程以返回查看构成该线程的消息，您还可以通过点击笔图标修改线程的标题（Cursor 线程的标题初始为第一条用户消息的前几个词），或在悬停在线程上时点击垃圾桶图标删除该线程。

🍃 默认上下文

默认情况下，Cursor Chat 包含当前文件作为上下文。您可以通过从消息中移除当前文件标签来提交不包含任何上下文的查询（😋认真些，还能添加其他文件作为上下文的组成部分）。当您输入时，您可以在输入框上方的标签中看到将包含的上下文。

上面的那些新的文件是通过点击@号出现的

但是，你还可以直接输入@添加更多自定义上下文（实质上和上面那种方式差不多，给出的可添加种类都一样且不如上面的直观，所以建议就直接点击@就OK）。完后记住这句废话“默认情况下，用户消息将包含您输入的文本，以及您引用的上下文”。

🍃 聊天中的AI修复

在编辑器中悬停在错误上，然后点击出现的蓝色 AI 修复按钮。

一个莫名其妙的小发现：

把光标放到代码区域的空行：

好神奇的小提示！

🍃 模型自定义

自动默认模型：

思考模型范围：

摆烂版纯粹自己选：

另外补充：

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

🍃 带代码库

🌱 代码库未被索引

Cursor Chat 将首先尝试计算几个搜索查询，以便在您的代码库中进行搜索。但是准确性不如直接索引。

🌱 代码库索引

您的代码库索引将自动与您最新的代码库更改同步。

您代码库索引的状态在 Cursor 设置 > 功能 > 代码库索引 下。

高级设置😐

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

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

如果您的项目中有任何大型内容文件，AI 确实不需要读取，忽略这些文件 可能会提高答案的准确性。（好复杂，不会忽略——现在我找到地方啦！😀）

在输入消息后按 Ctrl/⌘ + Enter（⭐按键不确定,但是感觉约等于“send”），Cursor Chat 会扫描您的索引代码库，以查找相关代码片段。这通常适合快速包含代码片段，以便在对话中使用。为了更好地控制代码库搜索并提高准确性，您可以使用 @codebase。

有关 @Codebase 的更多信息，请 点击这里。

🌳Ctrl+K

🍃编辑器内

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

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

• 行内编辑 对于就地编辑，您只需选择要编辑的代码并在提示栏中输入即可。

• 后续指令 在每次生成后，您可以通过向提示栏添加更多指令来进一步细化提示，然后按 Enter 以便 AI 根据您的后续指令重新生成。

• 默认上下文 默认情况下，Cursor 将尝试查找不同类型的有用信息以改善代码生成，除了您包含的手动 @ 符号。

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

• 快速问题 如果您在提示栏中按下 Option/Alt Enter，Cursor 将回答您关于所选内容和您附加的上下文的任何问题。（⭐按键不确定,但是感觉约等于“send”）

此对话的内容可以在后续生成中进一步使用，因此您可以在 Cursor 给出响应后简单输入“执行”以生成代码。

🍃 终端内

在内置的光标终端中，您可以按 Ctrl/⌘ K 在终端底部打开提示栏。您描述在终端中所需的操作， 将生成一个命令。您可以通过按 esc 接受该命令，或通过 Ctrl/⌘ + Enter 立即运行该命令（⭐按键不确定,但是感觉约等于“send”）。

🌳context上下文

🍃 代码库索引

前面讲过啦！

🍃 Cursor 人工智能规则

可以通过修改 Cursor 设置 > 常规 > 人工智能规则 部分来添加自定义指令到 Cursor。

一点小解释：

1️⃣ Rules（规则）：规则为AI模型提供更多上下文，帮助它们遵循你的个人偏好，并在你的代码库中更高效地运行。

2️⃣User Rules（用户规则）：这些偏好设置会发送到AI，在所有聊天、作曲和Ctrl-K会话中使用。

• 示例：例如，“始终用葡萄牙语回答，偏好简洁的答案，始终使用函数式代码”

3️⃣Project Rules（项目规则）：特定于项目的规则，帮助AI理解你的代码库并遵循项目的约定。它们可以被agent自动包含或获取，并与你的代码库同步。

• 当前没有找到项目规则，点击“+”按钮可以添加新规则。
• Include .cursorrules file（包含.cursorrules文件）：如果关闭，将不会在AI的规则中包含任何.cursorrules文件。

右上角按钮

• + Add new rule（添加新规则）：点击此按钮可以添加新的项目规则。

然后，这边还有推荐的人工智能规则 Cursor 人工智能规则 | Cursor文档-Cursor中文文档-Cursor AI文档

🍃 项目规则（推荐）

项目规则的主要特点：

• 语义描述：每条规则都可以包含何时应用该规则的描述
• 文件模式匹配：使用 glob 模式来指定规则适用的文件/文件夹
• 自动附加：在引用匹配文件时可以自动包含规则
• 文件夹特定：不同的规则可以应用于项目的不同部分

打开方式1：

（编辑区任意一行右键，点击“命令面板”，然后输入“New Cursor Rule”，接着填入规则就OK）

打开方式2：

（点击蓝色按钮）

存储位置：

.cursor/rules 目录中

使用示例：

• 特定文件类型的框架规则（例如，.tsx 文件的 SolidJS 偏好设置）
• 自动生成文件的特殊处理（例如，.proto 文件）
• 自定义 UI 开发模式
• 特定文件夹的代码风格和架构偏好

项目规则还包含.cursorrules部分：

🌱 .cursorrules

（实属现在还不太会用）

对于项目特定的指令，您可以在项目根目录中包含 .cursorrules 文件中的指令。

适用范围：与"人工智能规则"部分相同，.cursorrules 文件中的指令将包含在 Cursor Chat 和 Ctrl/⌘ K 等功能中。

cursorrules 集合网站： https://cursor.directory/ https://cursorlist.com/

🍃 忽略文件

在设置的这个地方：

点击Configure ignored files，然后项目的根目录就会多出红色的 💓.cursorignore 文件💓啦！它允许您从 Cursor 的代码库索引中排除文件和目录！

.cursorignore 参照 .gitignore。如果您已经有 .gitignore，则默认情况下将忽略这些文件。

目前，Cursor 聊天和 Composer 可以访问其上下文中的所有文件，无论 .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 文件发现器不会深入并发现子目录中的任何 .php 文件）。

🍃 基本用法

在 Cursor 的 AI 输入框中，例如在 Cmd K、聊天或终端 Cmd K，您可以通过输入 @ 符号来使用 @ 符号。弹出菜单将出现，列出建议，并会根据您的输入自动筛选，仅显示最相关的建议。

🌱 键盘快捷键&Cmd K 键盘快捷键

我总结了下，大概意思是如果你选择了一个类别，它会为你再度筛选；如果你主动点击这个类别，它会为你展开/折叠选定的上下文项。

您可以使用 Ctrl/⌘ M 切换文件读取策略。有关文件读取策略的更多信息，请点击这里。（目前发现——最新版没有这个快捷键也没有这个功能）

🍃 @Files

在 Cursor Chat 和 Cmd K 等 AI 输入框中，您可以通过使用 @Files 来引用整个文件。

Q：下面这句话我看不懂，你们看得懂嘛？

此外，如果您在 @ 后继续输入，您将在 @Code 策略后看到文件搜索结果。

为了确保您引用的文件是正确的，Cursor 将显示文件路径的预览。当您在不同文件夹中有多个同名文件时，这尤其有用。（最新版路径显示不全，但是点击可以跳转到引用的文件）

🌱 聊天长文件引用

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

（传说显示如下，但是我没有发掘出来过）

但是我发现了一个新的功能，就是在一个用户问题中，可以用ctrl+L多轮选出对应的所需要的代码，然后一起问大模型！😀

🌱 Ctrl K分块策略

对于 Ctrl K，Cursor 也根据内容长度以不同方式使用文件引用。

(虽然我感觉最新版感觉变成自动了，并且没有相关选项)

🌱 拖放

您可以将文件从主侧边栏拖放到聊天或 Cmd K 中，以将其作为上下文添加。

（试过，真的可以，不过会再多出一个@，并且删掉@文件就没了）

🍃 @Folder

可以将整个文件夹作为上下文引用。@Folders 在需要提供大量上下文时特别有用，例如在 长上下文聊天 中。(设置中有长上下文打开方式，但是容易导致上下文token消耗过多)

长上下文打开方式：

🍃 @Code

要引用特定的代码段，您可以使用 @Code 符号。

下面是“代码预览”😊：

下面是来自编辑器：

选择您想要引用的代码，然后“添加到聊天”（Ctrl/⌘ Shift L）或“添加到编辑”（Ctrl/⌘ Shift K）。

前面提到过的添加多段代码也指的是这个功能！

但是，😡“添加到编辑”加不到右边的编辑框中，只能在编辑器内编辑；“添加打破聊天”OK

结果：这些操作将把选定的代码片段添加到聊天输入框或当前活动的 Ctrl K 提示栏中。

🍃 @Docs

Cursor 附带了一套爬取、索引并准备好作为上下文使用的第三方文档。可以通过使用 @Docs 符号访问它们。

🌱 添加自定义文档

1.粘贴所需文档的 URL

2.出现以下模态框

3.新Doc上下文添加成功！

🌱 管理自定义文档

在 Cursor 设置 > 功能 > 文档 下，您将看到您添加的文档。您可以在此处编辑、删除或添加新文档。

🍃 @Git

⭐⭐在 Cursor 的聊天中，您可以使用 @Git 将 git 提交、差异或拉取请求添加到您的提示中。⭐⭐

例子

扫描差异并查找可能由差异引起的错误或问题：

从当前差异生成提交信息

🍃 @Codebase

通过 @Codebase，Cursor Chat 经过这些步骤，直到找到最重要的代码片段以供使用。

• 收集：扫描您的代码库以寻找重要文件/代码块
• 重新排序：根据与查询的相关性重新排列上下文项
• 推理：思考使用上下文的计划
• 生成：提出响应

打开方式：

PS：提交高级代码库查询的另一种方法是点击 Ctrl/⌘ + Enter 按钮旁边的下拉菜单，并选择 reranker 作为搜索行为。这仅在未使用 @Codebase 时可用，否则 @Codebase 优先。

⚠此方法最新版未发现

🍃 @Web

这边建议大家直接开启Web search tool：

永久开启网络搜索👍

如果你不想永久开，或者不放心，可以查看：@Web | Cursor文档-Cursor中文文档-Cursor AI文档

🍃 @Chat

用于添加当前聊天消息作为上下文。

但是现在只剩下了@Past Chats

🍃 @Recent changes

感觉这个比较有用，但是文档中没有着重介绍

🍃 @Definitions

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

(不太理解，但是这个只有在编辑器里面的Ctrl + K才能使用)

🍃 粘贴链接

（这部分的东西都没有试过😂）

为了让 Cursor 在响应之前访问链接，请输入 @ 然后粘贴链接。

🌱 移除链接

默认情况下，我们会自动解析链接并将其转换为 Cursor Chat 中的 @Links。如果您希望将链接作为纯文本显示，请点击链接，然后点击 取消链接。

🌳settings

🍃 概述

（一个大家都知道还要介绍的东西）

Cursor 设置让您可以根据自己的喜好配置 Cursor。通过 Cursor > Settings > Cursor Settings 访问它。

在这里，您可以：

• 导入您的 VS Code 设置。
• 编写您自己的 AI 规则。
• 配置编辑器设置。
• 管理您的 隐私 设置。

AI规则我们已经设置过啦，现在就专门介绍下隐私设置：(也不怎么重要啦)

🍃 模型

模型部分是您可以管理在 Cursor Chat、Ctrl K 和 Terminal Ctrl K 中可用的模型的地方。我们会在最新模型可用时立即将其添加到 Cursor。

在 AI 输入框下，您会看到一个下拉菜单，让您选择要使用的模型。默认情况下，Cursor 提供这些 模型。

🌱 模型下拉菜单

在 AI 输入框下方，您将看到一个下拉菜单，允许您选择要使用的模型。默认情况下，Cursor 已准备好使用以下模型：

• GPT-4o
• GPT-4
• Claude 3.5 Sonnet
• cursor-small
  • cursor-small 是 Cursor 的自定义模型，虽然不如 GPT-4 智能，但速度更快，用户可以无限制访问。

您可以在 Cursor Settings > Models > Model Names 下添加其他模型。

🐣模型 X 使用了什么上下文窗口？

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

如果您想使用由受支持的提供商提供的模型，但在此设置部分中未列出，则此功能尤其有用。请注意，如果启用，您将以公共 LLM API 成本使用 Cursor，受您特定账户的使用限制。

其他:

一些 Cursor 功能（如 Tab 完成、从聊天应用和 Composer）需要专用模型，并且无法与自定义 API 密钥一起使用。自定义 API 密钥仅适用于使用来自 OpenAI、Anthropic 和 Google 等提供商的标准模型的功能。

🌱 支持的提供商

我们支持所有主要的 LLM 提供商，包括：

• OpenAI
• Anthropic
• Google
• Azure

🍃 功能

🌱 1 Cursor标签

在这里，您可以在编辑器中启用 Cursor 标签 及其 高级功能。

🌱 2 聊天与创作

在这里，您可以配置 Cursor 聊天 并管理编辑器中的创作设置。

2.1 代理模式持久化

最新版没有这个选项

2.2 自动滚动到底部

当生成新消息时，自动滚动到创作窗格的底部。

2.3 自动应用于上下文外的文件

允许创作自动将更改应用于当前上下文外的文件。

2.4 在窗格或编辑器中折叠输入框药丸

在创作窗格或编辑器输入框中折叠药丸以节省空间。

2.5 以标签形式渲染

最新版没有这个选项

2.6 迭代修复警告 [测试版]

如果存在 linter 错误，创作将尝试逐步修复它们。

🌱 3. 代码库索引

在这里，您可以在编辑器中配置 代码库索引。

3.1 默认索引新文件

启用时，新文件将默认自动索引。如果禁用，您仍然可以通过按"计算索引"按钮来索引您的文件夹。
仅对少于 10,000 个文件的文件夹自动生成索引。

3.2 忽略文件

在索引期间，除了您的 .gitignore 外，还可以将文件添加到 忽略 列表中。
这对于排除您不想索引的大文件非常有帮助。

3.3 Git 图关系

启用时，Cursor 将索引您的 git 历史记录以了解文件之间的关系。
代码和提交消息存储在本地，而关于提交的元数据（SHA、变更数量和模糊文件名）存储在云中。

🌱 4. 文档

在这里，您可以在编辑器中配置和管理 文档。

🌱 5.编辑器

最新版这个已经没有图形化界面了:

然后点击"编辑器设置":

然后你就可以依据自己的喜好添加/修改里面的设置啦!

5.1 聊天/编辑工具提示 如果启用，在编辑器中高亮代码附近显示聊天/编辑工具提示。(未尝试)

5.2 自动解析链接 如果启用，Cursor 会自动解析链接并将其添加到上下文中。(好像一直支持)

5.3 自动选择 Ctrl/Cmd + K 如果启用，Cursor 会自动选择区域以进行内联代码编辑。(未尝试)

5.4 主题差异 如果启用，Cursor 在编辑器中使用主题背景颜色进行内联差异显示。(未尝式)

🌱 6.终端

6.1 显示终端悬停提示

如果启用，在终端中显示悬停提示，包含“添加到聊天”或“使用 AI 调试”的命令。(未尝试)

6.2 使用预览框

如果启用，Cursor 在终端中使用预览框显示 Ctrl/Cmd + K 的输出。如果禁用，响应将直接流入终端。(未尝试)

🌳billing

请注意，您只能自助从月度切换到年度账单。要从年度切换到月度账单，请通过 hi@cursor.com 联系我们。

专业版试用持续 14 天或直到达到我们 定价页面 上详细说明的使用配额。试用期结束后，您需要升级才能继续使用专业功能。您可以在试用期间的任何时间进行升级。

您可以通过账单门户直接使用“取消订阅”按钮取消您的订阅。您的访问权限将持续到您当前账单周期的结束。

您可以通过前往账单门户并点击取消订阅按钮自助申请退款。

如果您不在自助退款的窗口内，请通过 hi@cursor.com 联系我们，我们将为您解决。

• 月度订阅：购买后 24 小时内可退款。
• 年度订阅：购买后 72 小时内可退款。

🌳plans-business

开始使用 | Cursor文档-Cursor中文文档-Cursor AI文档

需要的话后面认真看哈!

🌳features

🍃 生成提交信息

步骤:

先登录github!😀

1. 暂存您想要提交的文件
2. 打开侧边栏中的 Git 选项卡
3. 查找提交信息输入字段旁边的闪光（✨）图标
4. 点击闪光图标，根据您的暂存更改生成提交信息

注: 生成的提交信息将基于您暂存文件中的更改和您仓库的 git 历史。这意味着 AI 将分析您当前的更改和之前的提交信息，以生成上下文适当的信息。

Cursor 从您的提交历史中学习，这意味着如果您使用像 Conventional Commits 这样的约定，生成的信息将遵循相同的模式。

🌱 快捷键

您可以将生成提交信息功能绑定到键盘快捷键。

1. 转到键盘快捷键 ⌘R ⌘S 或 ⌘⇧P 并搜索“打开键盘快捷键（JSON）”

2. 将以下内容添加到文件中以绑定到 ⌘M：

   {
     "key": "cmd+m",
     "command": "cursor.generateGitCommitMessage"
   }
   

3. 保存文件，完成！

🐼但是快捷键还要一个方法(好吧,上面那种方法我没试过不知道OK不)

这边的最后一行就OK啦!

然后,点击即可跳转到:

🍃 记事本

使用记事本在编译器和聊天之间共享上下文(注意它目前处于测试阶段)

先告诉大家打开方法:

把Notepads前面的小对号点开!

然后,下面就会多出来:

这个功能的具体部分还需要看记事本 | Cursor文档-Cursor中文文档-Cursor AI文档

🌳advanced

🍃 模型上下文协议

模型上下文协议 (MCP) 是一个开放协议，允许您为 Cursor 中的智能 LLM 提供自定义工具。

更多信息请看模型上下文协议 | Cursor文档-Cursor中文文档-Cursor AI文档

🍃 键盘快捷键

了解 Cursor 的键盘快捷键

通过这些键盘快捷键和按键绑定来学习 Cursor

这是 Cursor 中键盘快捷键和按键绑定的高级概述。您可以通过按 Cmd + R 然后 Cmd + S 查看所有键盘快捷键。

参考 VS Code 的按键绑定，它是 Cursor 按键绑定的良好基准。

在 Windows 上，所有 Cmd 键都可以用 Ctrl 键替代。

🌱 常规

快捷键	操作
Cmd + I	打开 Composer
Cmd + L	打开聊天
Cmd + .	切换 Composer 中的 Agent(没用)
Cmd + /	切换 AI 模型(只有在与Agent的交流中有用)
Cmd + Alt + L	打开聊天和 Composer 历史记录(没用)
Cmd + Shift + J	打开 Cursor 设置
Cmd + Shift + P	打开命令面板

🌱 聊天

快捷键	操作
Cmd + Enter	提交并包含代码库(未尝式,但是感觉和enter一样)
Enter	提交
↑	选择上一条消息(目前暂时只发现在ctrl+k调出的框里面有用)
选择代码, Cmd + L	将选中的代码添加为上下文
选择代码, Cmd + Shift + L	将选中的代码添加为上下文(千万别试验!)

🌱 Composer

快捷键	操作
Cmd + Backspace	取消生成(更像是取消采纳并且消除灰色建议)
Cmd + Enter	接受所有更改(不成立,疑似换行)
Cmd + Backspace	拒绝所有更改(不理解+未尝试)
Tab	切换到下一条消息(未尝试成功)
Shift + Tab	切换到上一条消息(未尝试成功)
Cmd + Alt + /	打开模型切换(无变化)
Cmd + N	创建新的 composer(这是创建新文件)
Cmd + R	创建新的 composer(这是打开新窗口)
Cmd + Shift + K	以栏形式打开 composer(不是很理解,好像必须在ctrl+k 后才能尝试成功)
Cmd + [	上一个 composer(没用)
Cmd + ]	下一个 composer(没用)
Cmd + W	关闭 composer(没用)
↑	选择上一条消息(上下都有用,还有@)

🌱 Cmd+K

🐖前三条找不到与上个的区别,第四条没试过

快捷键	操作
Cmd + K	打开
Cmd + Shift + K	切换输入焦点
Enter	提交
Option + Enter	快速提问

🌱 代码选择和上下文

快捷键	操作
@	@-符号
#	文件
Cmd + Shift + L	将选择添加到聊天(最新版无)
Cmd + Shift + K	将选择添加到编辑(最新版无,变为ctrl+k)
Cmd + L	将选择添加到新聊天(OK)
Cmd + M	切换文件读取策略 (没用)
Cmd + →	接受建议的下一个词(OK!!!!!)
Cmd + Enter	在聊天中搜索代码库(未尝试,估计有用)
选择代码, Cmd + C, Cmd + V	将复制的参考代码添加为上下文(没用)
选择代码, Cmd + C, Cmd + Shift + V	将复制的代码添加为文本上下文(没用)

🌱 Tab

快捷键	操作
Tab	接受建议
Cmd + →	接受下一个词

🌱 终端

快捷键	操作
Cmd + K	打开终端提示栏
Cmd + Enter	运行生成的命令(未尝试,估计有用)
Esc	接受命令(未尝试)

常见问题

🍃 我在更新日志上看到更新，但光标不会更新。

如果更新非常新，可能还没有推送到您那里。我们进行分阶段发布，这意味着我们首先将新更新发布给少数随机选择的用户，然后再向所有人发布。预计在几天内会收到更新！

🍃 我在光标中遇到GitHub登录问题 / 如何在光标中退出GitHub？

您可以尝试从命令面板中使用 Sign Out of GitHub 命令 Ctrl/⌘ + Shift + P。

🍃 我无法使用GitHub Codespaces。

不幸的是，我们尚不支持GitHub Codespaces。

🍃 我在连接远程SSH时遇到错误。

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

🍃 光标标签和Cmd K在我的公司代理后不起作用。

光标标签和Cmd K默认使用HTTP/2，这使我们能够以更低的延迟使用更少的资源。一些公司代理（例如某些配置中的Zscaler）会阻止HTTP/2。要解决此问题，您可以在设置中将 "cursor.general.disableHttp2": true 设置为真（Cmd/Ctrl + , 然后搜索 http2）。

🍃 我刚订阅了Pro，但在应用中仍然是免费计划。

尝试从光标设置弹出窗口中注销并重新登录。

🍃 我的使用情况何时会重置？

如果您订阅了Pro，您可以从仪表板中点击 Manage Subscription，您的计划续订日期将显示在顶部。

如果您是免费用户，您可以检查您收件箱中第一次收到我们的电子邮件的时间。从那时起，您的使用情况将每月重置一次。

🍃 我该如何卸载光标？

您可以按照此指南卸载光标。将每个“VS Code”或“Code”的出现替换为“Cursor”，并将“.vscode”替换为“.cursor”。

---

哇!而且现在好像可以接入Deepseek-v3啦!感觉超级好玩!

PS: 论坛:论坛 | Cursor文档-Cursor中文文档-Cursor AI文档