Cursor使用教程快速入门版

1. Cursor介绍1.1 什么是CursorCursor是一款AI优先AI-First的智能代码编辑器它基于成熟的Visual Studio Code架构深度优化将大型语言模型LLM原生集成到编辑器的每一个交互环节。与传统IDE或“编辑器AI插件”模式不同Cursor从底层设计就围绕AI能力构建旨在成为开发者的智能结对编程伙伴而不仅仅是代码书写工具。技术架构与定位● 基于VS Code内核完全兼容VS Code的插件生态、快捷键和用户界面确保开发者零成本迁移。● AI原生集成AI能力不是附加功能而是编辑器的核心引擎支持对整个代码库的语义理解和跨文件智能操作。● 多模型支持可在OpenAI、Anthropic、Gemini、xAI及Cursor自有模型间灵活切换为不同任务选择最佳模型1.2 核心优势项目级上下文理解能力Cursor默认对整个项目代码库进行索引和嵌入Embedding建立全局语义关联。这意味着● 毫秒级全库扫描当询问“这个接口在哪里被调用”时Cursor能瞬间给出精准答案。● 跨文件关联推理AI能理解模块间的依赖关系进行智能重构和修改。● 自动上下文注入提问时自动关联相关文件无需手动提供背景信息。四模式对话式编程体验Cursor提供四种精心设计的AI交互模式每种模式针对不同场景优化权限和工作流模式 适用场景Agent模式 复杂功能开发、重构、修复BugPlan模式 需要规划的复杂功能Debug模式 棘手Bug、回归问题Ask模式 学习、探索、理解代码模式选择策略不确定时从低权限开始Ask→中权限Plan→高权限Agent确保安全可控。智能编辑与自动化工作流● Composer 2突破采用“自我总结”强化学习方法在处理长任务时主动暂停、总结关键信息并压缩上下文将token用量降至传统方法的1/5。● 云端并行智能体Agent在云端虚拟机中自主运行不占用本地资源支持同时运行10-20个任务。● 成本优势显著Composer 2标准版定价为每百万输入token 0.50美元、输出2.50美元相比前代降幅高达86%。企业级安全与隐私● 隐私保护模式支持零数据存储的本地处理选项。● 安全审查自动化内部部署的安全审查Agent在每次代码推送时自动触发。● 合规性支持满足企业级数据安全和合规要求。2. 安装与配置2.1 安装cursor直接在官网下载安装即可并且注册账号在第一次打开cursor时输入账号信息即可。cursor官网https://www.cursor.com/注册成功后打开cursor一般会有四个区域也可以点击右上角设置看下可以有各种设置后面慢慢探索。先看下PlanUsage新注册的我有30天免费使用额度。cursor也内置了很多模型可以配置自己的API Key使用。2.2设置中文先下载中文包搜索“中文”点击install。然后配置按下 Ctrl Shift P (Mac 是Command Shift P)输入 language→ 选择 Configure Display Language→ 选择 “中文(简体)”然后重启即可。2.3快捷键在设置里找到Keyboard Shortcuts打开可以看到所有的快捷键一些常用的如下Tab 接受AI补全Esc 拒绝补全Ctrl/Cmd L 打开关闭AI工作区Ctrl/Cmd I 打开ComposerCtrl/Cmd J 打开关闭终端Ctrl/Cmd / 在AI聊天框中切换AI模型Ctrl/Cmd K 编辑代码Ctrl/Cmd → 生成代码后逐字接受补全Ctrl/Cmd Backspace 拒绝已应用的修改Ctrl/Cmd Shift J 打开设置面板Ctrl/Cmd Shift P 命令面板Ctrl/Cmd . 切换聊天模式Alt/Option Enter 快速问答2.4 插件扩展Cursor完全兼容VS Code扩展市场同时提供专属AI扩展如何打开扩展面板快捷键CtrlShiftX侧边栏图标点击活动栏最下方的方块图标命令面板CtrlShiftP→ 输入扩展一些插件推荐configure display language中文支持Pythonpython开发智能感知、调试、测试JavaJava开发支持markdownlint支持markdown文档的阅读编辑Git Graphgit分支管理工具和可视化Extension Pack for JavaJava开发基础套件包含语言支持、调试、Maven等核心功能提供代码补全、重构工具Debugger for Java支持断点调试、变量监控、表达式求值兼容主流框架Spring、Jakarta EEMaven for Java集成 Maven 依赖管理支持 pom.xml 可视化编辑、生命周期命令执行mybatis jump to mapper xml在 MyBatis 的 Java Mapper 接口与 XML 映射文件之间快速跳转解决多文件无法关联跳转的痛点3. 核心功能3.1 代码自动补全cursor可以根据你的文件名你的注释甚至你的类名函数名以及你的上一行代码来联想你下面要写的代码进行代码补全我们只需要tab接受即可。如下根据文件名预测了函数名如下根据上面的代码知道我在写快排自动补充下一行代码3.2 AI对话项目开发我们也可以直接通过右侧的AI对话框输入我们的指令让它帮我们完成想要完成的功能。下面以一个贪吃蛇游戏为例。如下我让它帮我写一个贪吃蛇的游戏页面设计到cd的命令行它会停留等待我们是否执行点击run左侧文件时它帮我们生成的文件右侧是它生个思考和项目完成的过程当然中间有些指令需要我们手动点击run或确认。最后也是完成了贪吃蛇游戏。在现有项目基础上我们还可以继续让他做一些优化如让蛇的速度慢一点蛇的头部形状改为圆形3.3 四种对话模式Cursor提供四种精心设计的AI交互模式每种模式针对不同场景优化权限和工作流。Cursor提供四种精心设计的AI交互模式每种模式针对不同场景优化权限和工作流模式适用场景核心能力权限级别Agent模式复杂功能开发、重构、修复Bug自主探索、多文件编辑、运行命令、修复错误高权限可自主修改代码Plan模式需要规划的复杂功能执行前创建详细计划提出澄清性问题生成可审阅方案中权限需确认后执行Debug模式棘手Bug、回归问题生成假设、日志埋点、运行时分析、结合调试服务器高权限可插入日志和修复Ask模式学习、探索、理解代码只读探索搜索代码库并提供答案不修改代码低权限只读安全探索模式选择策略不确定时从低权限开始Ask→中权限Plan→高权限Agent确保安全可控。下面以Plan模式为例演示一下。如下修改需求现在我想把对贪吃蛇吃的东西却分不同形状分数也不同同时贪吃蛇体型要随着吃的东西慢慢变大。这时候它会提出一些澄清性问题以明确具体的需求。食物我选择B方案体型增长我选择了A方案然后点击continue。这时候它会列出详细的计划点击build执行计划。执行完之后右下角会有选项我们可以选择撤销修改接受全部review来查看所有的修改。我们也可以直接让他帮我们启动项目4. 高级功能4.1 符号符号是一个强大的上下文引用工具它允许你在与AI对话时直接引用项目中的文件、函数、类或代码片段为AI提供精确的上下文信息从而获得更准确、更相关的回答。具体可以哪些东西如下Files Folders文件夹文件图标项目管理核心入口用于浏览、创建、删除、重命名项目内的“文件和文件夹”是代码文件、资源文件的“目录管理器”。Docs书本图标文档中心一般关联三类内容● 项目内置文档比如团队协作的README、API说明● 工具自身的帮助文档比如该软件的操作指南● 第三方技术文档若工具支持一键唤起MDN、官方SDK文档等。Terminals终端图标功能命令行终端在工具内直接打开命令行界面如终端/Terminal用于执行代码编译、脚本运行、环境配置比如npm installpython manage.py runserver等命令是开发者“命令行操作”的快捷入口。Past Chats对话气泡图标功能历史对话记录保存你与该工具尤其是AI辅助功能的“过往聊天”方便回溯之前的提问、代码生成记录、问题解决方案等。Branch (Diff with Main)分支图标 “与主分支对比”功能版本控制Git分支 差异对比● Branch表示当前处于哪个Git分支● (Diff with Main)表示可一键查看“当前分支”与“主分支main”的代码差异谁改了哪、新增/删除了什么代码是Git协作中“合并代码前检查冲突”“同步改动”的高效方式。Browser地球图标功能内置浏览器在工具内直接打开网页无需切出软件常见场景● 快速访问技术博客、Stack Overflow等“即时查资料”● 打开项目关联的在线文档/部署地址比如Vercel预览页、GitHub Pages。这些选项的设计逻辑是把开发者日常高频操作文件管理、终端、Git、文档、浏览器聚合到侧边栏减少切换工具的成本让编码流程更流畅 如果是特定工具比如Cursor、GitHub Copilot、VS Code插件等功能细节会略有差异但核心逻辑一致。示例使用“file”让AI只看一个文件如下我直接输入main.js让后让他帮我统计有多少行代码如果你的改动只涉及一个文件最好使用此功能可以减少AI的上下文减少token消耗减少幻觉。有个小技巧可以直接拖动指定文件或文件夹完成Files Folders的功能。4.2 rules4.2.1 什么是rulesCursor Rules 是一套持久化的AI行为控制指令系统你可以把它理解为“给AI定制的系统提示词”。通过设置规则你可以让Cursor的AI助手在分析、生成代码时自动遵循你的项目规范、编码风格和个人偏好无需每次重复说明。核心价值● 一致性确保AI生成的代码符合团队/项目规范● 效率减少重复提示和代码修改时间● 可维护性规则文件可版本控制随项目一起管理● 个性化根据项目类型、技术栈定制AI行为4.2.2 如何添加rules可以在设置里添加rulesrules分为两种全局规则User Rule和项目规则Project Rule。如下我添加一个web的Project Rule当然我们也可以让Agent帮我们写命令是 /create-rule创建完了如下他会在项目中生成 .cursor\rules 文件夹然后生成对应的 .mdc 文件。当然如果我们有 .cursor\rules 文件夹后也可以直接创建对应的 .mdc 文件即可。还有一种方法是命令面板创建按 Cmd/Ctrl Shift P打开命令面板输入 “New Cursor Rule”。4.2.3 rules四种规则Cursor 支持四种规则类型Always Apply始终应用无论当前上下文如何强制对所有聊天Chat和 cmdK命令会话应用该规则。适用场景● 全局通用配置例如强制所有代码文件添加版权注释、统一的代码风格如缩进、分号或配色方案。● 无条件生效的逻辑无需根据文件类型或内容差异调整的行为如所有文件禁止使用硬编码颜色如 #ffffff。示例在代码规范中要求所有函数必须添加 JSDoc 注释且该规则始终生效不因文件路径或用户指令变化而改变。Apply Intelligently智能应用根据用户输入的自然语言描述或上下文智能判断是否触发规则。适用场景● 动态适配需求当用户明确提及特定需求时触发规则例如在请求中包含“需要兼容旧版本”时自动应用向后兼容的代码转换逻辑。● 减少冗余提示避免对无关场景频繁弹出建议仅当上下文相关时才介入。示例若用户在聊天中询问“如何优化数据库查询性能”规则自动触发性能优化相关的代码建议若讨论其他话题如 UI 设计则不触发。Apply to Specific Files应用于特定文件仅当文件匹配预设的模式如路径、文件名、正则表达式时才触发规则。适用场景● 差异化文件配置不同类型文件需遵循不同规范例如○ 测试文件*.test.js强制添加测试覆盖率注释○ 配置文件.env、config.json禁止提交敏感信息触发安全检查规则。● 临时排除文件在重构或迁移时对特定目录的文件应用过渡性规则。示例在项目中所有 src/components目录下的 Vue 组件文件需统一使用4.2.4 规则文件(.mdc)详细语法基本结构如下--- description: 规则描述 - 何时应用此规则 globs: [*.js, *.ts] # 文件模式匹配 alwaysApply: false # 是否始终应用 --- # 规则标题 ## 编码规范 - 使用2个空格缩进 - 行尾不要有空格 - 使用单引号而不是双引号 ## 项目特定要求 - 所有API调用必须包含错误处理 - 组件必须包含单元测试 - 使用项目特定的工具函数库 ## 禁止事项 - 不要使用var声明变量 - 不要使用alert/confirm/prompt - 不要直接修改DOM还有一些高级功能文件引用file语法--- description: TypeScript项目配置 globs: [*.ts, *.tsx] --- # TypeScript开发规范 file ./tsconfig.json # 引用TypeScript配置 file ./eslintrc.js # 引用代码检查配置 file ./api-guide.md # 引用API文档 - 严格遵守tsconfig.json中的配置 - 所有导出必须有类型定义 - 避免使用any类型多规则链式引用# frontend-rules.mdc --- description: 前端通用规则 globs: [*.js, *.ts, *.jsx, *.tsx] --- file ./coding-style.mdc file ./react-specific.mdc # 前端特定规则 - 使用ES6语法 - 组件必须可复用条件规则--- description: 测试文件特殊规则 globs: [*.test.js, *.spec.js, **/__tests__/*.js] --- # 测试文件规则 - 测试描述必须清晰 - 每个测试用例独立 - 使用describe/it结构总结Cursor代表的“AI原生IDE”范式正在重塑软件开发流程从“人写代码”到“人定义规则、AI执行任务”从“单兵作战”到“人机协同规模化协作”。随着云端并行智能体、多模态交互图像/文档生成代码等技术的演进Cursor将持续降低编程门槛、提升创造上限。Cursor还有很多功能这里没有介绍后续有机会再进一步讲解一些其他玩法。当然还有其他的AI coding工具比如claude code、codex等后面还会一一学习怎么使用让我们一起拥抱AI带来的爆炸式生产力提升。