Cursor 使用教程：从安装到完成第一个 AI 编程项目

教程目标与准备工作

本教程从官方安装开始，完成登录、打开项目、确认索引、使用对话和编辑、让 Agent 完成一个小改动、运行测试并审查差异。适合第一次使用 Cursor 的开发者。示例不要求绕过付费、地区、组织权限或安全限制；账户能用哪些模型和 Agent 次数，以当前计划为准。

开始前准备一个可以在本机正常运行的小项目，确认自己知道启动和测试命令，并先用 Git 提交或备份当前状态。不要用生产服务器、真实客户数据或含密钥的目录做第一次练习。更多入门文章可查看 使用教程 与 AI 编程与开发。

第一步：从官方入口安装 Cursor

在 Cursor 官方下载入口选择与你的 Windows、macOS 或 Linux 系统匹配的安装包。安装前核对域名和签名，不从网盘、群聊或第三方“共享版”下载安装程序。组织设备如果有软件白名单、代理或终端管理策略，应先按管理员流程申请。

完成安装后启动应用。首次打开可选择导入现有编辑器的设置、主题、快捷键和扩展，也可以保持默认配置。初学者建议只导入确定需要的配置，避免旧扩展、代理或键位冲突影响排查。

预期结果：Cursor 正常启动，能看到欢迎页或项目选择界面。若打不开，先检查系统版本、磁盘空间、安全软件和企业代理，不要通过关闭全部安全防护来“解决”。

第二步：登录并确认计划边界

使用自己的官方账户登录。Hobby 计划提供有限 Agent 请求和 Composer；Pro、Pro+、Ultra、Teams 与 Enterprise 有不同用量、模型和管理权益。登录后先查看当前计划、用量和按需计费设置，避免在教程中意外产生超出预算的费用。

团队账户还应确认 Privacy Mode、模型允许列表、仓库权限和组织规则。不要购买来源不明的共享账户，也不要把他人的会话或 API 凭据导入本机。需要通用方案讨论时可以另用 ChatGPT 或 Claude，但不要在多个服务重复上传敏感仓库。

预期结果：账户头像、计划和设置页面可见，组织策略没有报错。

第三步：打开项目并建立干净基线

选择 Open Folder 或项目选择器，打开准备好的项目根目录。不要直接打开包含整个用户目录、下载目录或大量无关仓库的父文件夹。项目越聚焦，索引、搜索和权限越容易控制。

在终端里先运行项目原有命令，例如状态检查、构建或单元测试。记录当前是否已有失败，防止把旧问题误认为 Agent 新引入的问题。再查看 Git 状态，确认没有不想混入练习的未提交修改。

预期结果：文件树只包含本项目，基线命令有明确结果，Git 状态可解释。如果项目本来就失败，先保存失败日志，并把教程目标缩小到不依赖该失败的改动。

第四步：检查代码库索引与忽略范围

Cursor 会为项目建立搜索上下文。第一次打开较大仓库时需要等待索引。确认状态完成后，问一个可以由代码验证的问题，例如“应用入口在哪个文件”“测试命令在哪里定义”“用户输入经过哪些函数”。要求回答列出文件路径和关键符号。

如果答案引用不存在的文件或漏掉核心模块，先检查项目根目录是否正确、相关目录是否被忽略、子模块是否已拉取、生成代码是否需要保留。不要把密钥、构建产物、依赖缓存和大型二进制文件加入上下文。索引是检索工具，不是完整理解保证。

预期结果：Cursor 能指出真实文件，开发者可以手动打开并核对。无法核对的结论不要进入下一步。

第五步：先用对话澄清任务

第一次项目建议选择一个小而可测试的目标，例如“为现有输入校验函数补充空字符串和超长输入测试”，或“在已有页面显示一个来自现有接口的状态字段”。不要从“重写整个项目”开始。

一个清晰的任务说明应包含：当前行为、期望行为、允许修改的文件、不能改变的接口、错误处理、测试命令和完成标准。先让 Cursor 只分析并输出计划，不要马上编辑。检查计划是否找到正确入口，是否意外提出升级依赖、改数据库或大规模重构。

可用提示结构：说明目标；列出限制；要求先定位相关文件；要求给出最小修改计划；明确在获得确认前不执行命令。Side Chat 可用于单独调查一个疑问，但主任务仍保留清楚的验收标准。

第六步：使用编辑或 Agent 完成最小改动

计划确认后，让 Cursor 按一个行为一轮修改。简单函数可使用选中代码后的行内编辑；涉及多个文件和测试时可使用 Agent。要求它每次说明修改了哪些文件、为什么修改，以及准备运行什么命令。

Agent 请求执行命令时先阅读命令本身。格式化、单元测试和只读搜索通常风险较低；安装系统软件、修改全局配置、删除目录、访问生产服务和批量网络请求属于高风险动作，应暂停并人工处理。教程不需要扩大管理员权限。

预期结果：差异集中在目标文件和测试文件，没有无关格式化或大批依赖锁文件变化。若范围扩大，立即停止并撤销本轮未接受的改动，再缩小提示。

第七步：运行测试与静态检查

让 Cursor 建议验证命令可以，但最终由你确认并运行项目真实命令。至少执行针对改动的单元测试，再根据项目情况执行完整测试、类型检查、格式化和静态分析。阅读完整输出，不能只看 Agent 总结的“通过”。

测试失败时，把最小错误日志提供给 Cursor，要求先解释原因和证据，不要连续让它盲目尝试。区分环境缺失、旧基线失败和新代码回归。每次修复后重新运行同一命令，直到得到新鲜结果。

预期结果：目标行为有测试覆盖，相关验证命令退出成功；若仍有基线失败，报告中明确列出而不是隐藏。

第八步：逐行审查变更

在差异视图中检查每个文件。重点看接口签名、默认值、异常处理、权限检查、日志、用户输入、依赖和测试断言。确认没有硬编码密钥、调试输出、跳过安全检查或为了通过测试而删除重要逻辑。

让 Cursor 解释某一行可以辅助理解，但解释不能代替代码事实。对陌生实现可请求它给出替代方案和权衡，再由开发者决定。审查完成后再次查看 Git 状态，确保没有临时文件、生成物或无关修改。

预期结果：开发者能解释每个变更的目的，并能把它映射到验收标准。无法解释的代码不应提交。

第九步：记录结果并提交自己的变更

写一段简短说明：改了什么、为什么、如何验证、有哪些未解决风险。提交信息应描述行为变化，不要只写“AI 修改”。如果团队使用 PR，把测试输出、截图或复现步骤附上，并按代码所有者和 CI 流程审查。

Cursor 可以辅助整理说明和处理审查意见，但合并和发布仍由有权限的人负责。移动端或 Slack 中看到“任务完成”时，也要回到仓库检查真实差异与 CI 状态。

一套适合首个项目的完整提示

可以按下面的结构组织，不需要照抄具体文件名：先说明“这是一个练习项目”；要求读取项目说明和测试配置；描述一个小行为；限制只能修改相关源文件和测试；禁止升级依赖、改数据库、访问外部服务；要求先给计划；确认后再修改；最后运行指定测试并汇总差异。

如果 Cursor 提出的计划与仓库不符，先纠正上下文，不要用更多模糊文字叠加。任务越小，第一次成功的概率越高。熟悉后再逐步尝试多文件重构、Cloud Agent 或自动化。

隐私与权限检查清单

开启组织要求的 Privacy Mode，但不要把它理解为完全离线。确认仓库是否允许使用在线 AI，清除环境文件和日志中的密钥，限制 Agent 可访问的目录与终端权限。企业代理、SSO、模型限制和审计设置由管理员管理，不应自行绕过。

对含个人信息、医疗、财务、合同或客户代码的项目，先做脱敏和授权评估。若组织政策禁止上传，就不要使用在线索引或模型处理该仓库，可改用获批的本地或企业方案。

常见问题

索引一直没有完成怎么办？ 检查项目是否过大、网络或代理是否阻止 Cursor 后端、忽略规则是否合理。先打开更小的项目验证，不要关闭企业安全策略。

Agent 修改了太多文件怎么办？ 停止任务，查看差异，只保留可解释的改动；必要时撤销本轮修改，并把任务限制到具体文件和单一行为。

测试命令需要管理员权限怎么办？ 先确认项目是否配置错误。不要为了教程提升系统权限；应使用正常开发环境或让管理员提供获批方案。

免费计划能完成本教程吗？ 小项目通常可以尝试，但有限 Agent 请求可能不足。不要通过共享账户或规避计费限制获取更多用量。

Cursor 的答案和 DeepSeek 不一致怎么办？ 回到代码、文档和测试证据，不按品牌投票。让每个工具列出依据，再由开发者验证。

完成后可以直接部署吗？ 不可以仅凭 Agent 结论部署。仍需完整测试、安全检查、代码评审、变更审批和回滚计划。