Cursor: Your AI-Powered Code Editor - A Comprehensive Guide
Welcome to Cursor, the AI-native code editor designed to revolutionize the way you write, understand, and debug code. This guide will walk you through its core features, from basic setup to advanced AI-powered workflows.
0. 无限续杯工具直接到文档最后获取！！
1. 核心理念：什么是 Cursor？
Cursor 是一个基于 VS Code 深度定制的现代化代码编辑器。它完整继承了 VS Code 的所有功能、生态和稳定性，并在此基础上，将强大的 AI 能力无缝地融入到编码的每一个环节。
为什么要使用 Cursor？
- 上下文感知： Cursor 的 AI 能够理解您的整个代码库，提供精准、贴合项目实际的回答和代码建议。
- 无缝集成： AI 功能不是一个孤立的窗口，而是与编辑器、终端、调试器深度融合，让您在心流状态下完成工作。
- 效率革命： 大幅减少在查阅文档、编写样板代码、重构和调试上花费的时间。
- 继承 VS Code 生态： 您喜爱的所有 VS Code 主题、快捷键和扩展插件都能在 Cursor 中完美使用。
2. 核心 AI 功能
这是 Cursor 最具魅力的部分。掌握它们将极大提升您的开发效率。
2.1. 与代码对话 (Chat)
这是最核心的交互方式。按下 Cmd+L (macOS) 或 Ctrl+L (Windows/Linux) 打开聊天面板。
- 提问： 您可以像和人对话一样，向 AI 提出任何关于编程的问题。
@符号引用: 这是 Cursor 的精髓所在。通过@符号，您可以将代码库中的任意元素作为上下文引入对话：@File: 引用一个或多个文件。例如:@src/app.ts@Symbol: 引用一个具体的函数、类或变量。例如:@calculatePrice@Docs: 引用某个库的文档，让 AI 基于官方文档回答。例如:@React@Terminal: 引用终端上一次命令的输出。
示例: " @app/layout.tsx 和 @app/page.tsx 这两个文件的区别是什么？"
2.2. 行内代码生成与编辑 (Inline Edit)
这是最快捷的编码方式。在编辑器中，按下 Cmd+K (macOS) 或 Ctrl+K (Windows/Linux) 激活行内 AI。
- 从零生成 (Generate): 在空行或空白文件中按下
Cmd+K，输入您的需求，AI 将直接为您生成代码。提示: "用 TypeScript 创建一个 React 的登录表单组件，包含用户名和密码字段。"
- 编辑/重构 (Edit): 选中一段代码，按下
Cmd+K，然后提出您的修改要求。提示: "将这个函数改成异步函数，并添加 try-catch 错误处理。"
- 接受/拒绝/修改: AI 生成的代码会以差异视图（Diff View）的形式展示。您可以选择接受、手动修改，或者放弃此次生成。
2.3. 一键修复 (Quick Fix) & 诊断错误
当您的代码中出现 linter 错误（红色波浪线）时，将鼠标悬停在错误上，除了 VS Code 自带的“快速修复”外，Cursor 还会提供一个 "Fix with AI" 的按钮。点击它，AI 会自动分析并修复错误。
2.4. “右键菜单”中的 AI
在编辑器中右键单击，上下文菜单里集成了多个便捷的 AI 功能：
- Add to Chat: 将选中的代码片段快速添加到聊天面板，并附带
@引用。 - Edit with AI: 功能同
Cmd+K。 - Generate Docs: 为选中的函数或类自动生成符合标准格式的文档注释。
3. 起步与配置
3.1. 安装
从 Cursor 官网 下载对应操作系统的安装包即可。
3.2. 项目设置
- 打开项目： 和 VS Code 一样，通过
File > Open Folder...打开您的项目。 - AI 配置：
- 打开聊天面板 (
Cmd+L) 或设置 (Cmd+,)。 - 您可以选择使用 Cursor 默认提供的模型（需要登录），或者配置您自己的 API Key (如 OpenAI, Anthropic 等)。
- 建议在设置中调整 AI 模型，例如在 Pro/Business 订阅下选用 GPT-4o 或 Claude 3 Opus 来获得更高质量的响应。
- 打开聊天面板 (
3.3. 快捷键
熟悉并自定义快捷键是提升效率的关键。最重要的几个默认快捷键是：
| 功能 | macOS | Windows/Linux |
|---|---|---|
| 聊天面板 | Cmd+L | Ctrl+L |
| 行内生成/编辑 | Cmd+K | Ctrl+K |
| 自动修复 | Cmd+Shift+R | Ctrl+Shift+R |
| 接受 AI 修改 | Cmd+Enter | Ctrl+Enter |
| 放弃 AI 修改 | Esc | Esc |
您可以在 File > Preferences > Keyboard Shortcuts 中查看和修改所有快捷键。
4. 高级用法与技巧
- AI 驱动的调试 (
Code Lens): 在调试过程中，AI 会在代码上方给出提示（Code Lens），例如“这个变量的值可能是 null”，帮助您更快定位问题。 .cursor-rules文件: 在项目根目录创建.cursor-rules文件，可以为整个项目设定 AI 的行为准则。例如，您可以规定 AI 必须遵循的编码风格或技术栈。 - Follow the coding style of the current file. - Use functional components and React Hooks. - Write all comments in Chinese.- 多模型切换: 在聊天框的输入区域，您可以临时切换本次对话使用的 AI 模型，以应对不同复杂度的任务。
5. 典型工作流示例
场景一：开发一个新功能
- 构思与规划: 打开聊天面板 (
Cmd+L)，"我需要用 Next.js 和 Tailwind CSS 创建一个产品展示页面，页面需要包含产品图片、名称、价格和购买按钮。请帮我规划一下文件结构和关键组件。" - 创建文件与生成代码: 根据 AI 的建议创建文件（如
ProductCard.tsx）。在空文件中按下Cmd+K，输入 "创建一个产品卡片组件，接收 props: imageUrl, name, price"。 - 迭代与优化: 选中生成的代码，再次
Cmd+K，"给购买按钮添加一个点击事件处理器handleBuy，并在点击时打印产品名称到控制台。" - 样式调整: 选中某个
div，Cmd+K，"使用 flex 布局让这张卡片的内容垂直居中，并添加一个阴影效果。"
场景二：代码重构
- 定位代码: 找到一个写得比较复杂的函数。
- 启动重构: 选中整个函数，按下
Cmd+K。 - 下达指令: 输入重构要求，例如：
- "将这个函数拆分成三个更小的、职责单一的函数。"
- "优化这个算法，降低时间复杂度。"
- "为这个函数添加 JSDoc 注释，并增加参数类型检查。"
- 审查与应用: 在 Diff 视图中仔细检查 AI 的修改是否符合预期，然后接受。
6. 无限续杯使用
- 下载工具包curs0rgo: gitee.com/mrs_zhouo/c…
- 使用工具之后的效果:
使用Cursor常见问题
Free users can only use GPT 4.1 or Auto as premium models
- 确保提取的不是过期token
- 确保使用的客户端支持防掉试用
- 如果使用curs0rgo确保使用的是最新版
- 确保cursor更新后使用换号客户端修补过
自动退出、提示要登录cursor
- 换一个账户试试
curs0rgo提示修补失败
- 检查是否修改了默认安装路径
- 修改默认安装路径后要使用修改路径功能
- mac下是否给了允许修改app的权限
curs0rgo打开闪退
- 检查是否同时打开了同类型的换号软件
- 检查localhost:14285端口是否被其他程序占用
- 不会的话就重启电脑
有150次的额度，为什么只能用50次
- 原因： 使用太快了（一天内用完都算快）
- 解决办法：换号
Your request has been blocked as our system has detected suspicious activity from your account.
- 换ip
- 换号
- 把 cursor setting里边的rules清掉
点击换号后显示“Cursor已损坏，无法打开。你应该将它移到废纸篓。”
- 新装（更新）后mac都会进行一遍程序校验，修补Cursor破坏了完整性，可能你安装后没打开就进行了换号，或者刚好碰到需要更新。
- 解决办法： 重新下载Cursor——安装后打开一遍——再进行换号操作
