Cursor 是一款采用类似 Visual Studio Code 工作方式的 AI 代码编辑器。它的价值不只是和模型聊天，还在于读取项目上下文、提出跨文件修改，并协助运行验证命令。下面用一次完整的小任务，讲清楚 Cursor 怎么用，同时确保每一步都能检查和撤回。
安装 Cursor 前要准备什么
从 Cursor 官方下载页获取安装程序，并确认网址属于 cursor.com。当前官方快速入门提供 Windows、macOS 和 Linux 的安装说明，但支持系统和安装包可能变化，不要使用旧镜像、破解包或来历不明的“中文版”。
再准备一个小型练习项目。最好包含 README、少量源码，以及可以运行的测试或构建命令。首次练习不要直接使用重要生产项目；开始前先备份未提交内容，或者创建一个 Git 提交。
安装、登录并打开项目
- 下载并运行适合当前操作系统的安装程序。
- 启动 Cursor，设置快捷键、主题和终端偏好。
- 如果需要账号对应的 AI 功能，按当前界面完成登录。
- 选择 Open Folder，打开练习项目的根目录。
- 等待项目索引基本完成，再提出涉及整个代码库的问题。
Cursor 官方安装文档说明，可以打开命令面板并搜索 Cursor: Start Onboarding，重新进入初始设置。如果从 VS Code 迁移，不要默认所有设置和扩展都安全兼容，建议逐项检查。
先提出一个只读问题
打开 Agent，让它解释项目中一个明确的小范围内容。第一次提示词可以这样写：
阅读 README 和包管理配置，说明怎样在本地运行这个项目。
暂时不要修改文件，也不要执行命令。列出回答中使用的假设。这个步骤用于确认 Cursor 是否找到正确文件，以及回答是否符合仓库实际情况。若它编造命令或遗漏项目指令，应先补充上下文，不要立即让它修改代码。
要求完成一个边界清晰的修改
选择容易验证的任务，例如改进一条错误提示或补充一个小测试。提示词中写清目标、不能改变的边界和验证命令：
修改注册表单中“姓名为空”的错误提示。
保留现有校验库和公开接口，不要顺带重构。
新增或更新最小范围的测试，然后运行该测试。
先展示变更差异；若检查失败，解释原因后再继续。不要只写“优化整个项目”。这类请求会让 Agent 获得过大的修改范围，也让评审更困难。较大的需求应先要求生成计划，再逐步确认。
接受修改前审查差异
把 AI 生成代码当成新同事提交的 Pull Request，逐个文件检查：
- 是否解决了指定问题，同时没有无关重构？
- 是否保留原有接口、依赖和代码风格？
- 错误处理、无障碍、多语种和安全路径是否仍然有效？
- 新测试是在验证行为，还是只复制了实现细节？
- 命令是否意外修改锁文件、生成文件或环境配置？
不合适的部分可以单独拒绝或要求重做。模型的解释再有信心，也不能替代真实差异和检查输出。
运行项目真正使用的检查
优先执行仓库文档已经规定的命令。JavaScript 项目可能使用以下命令，但你的项目不一定相同：
pnpm test
pnpm lint
pnpm build完整阅读输出。命令失败时，应先让 Cursor 解释失败原因，不要授权它通过删除测试、放宽类型或关闭规则来制造“通过”。
可重复使用的 Cursor 工作流程
以后处理任务时，可以重复以下六步：
- 检查： 找到相关文件、项目指令和当前行为。
- 计划： 写清期望结果、边界和风险。
- 修改： 完成最小且完整的一组变更。
- 评审： 检查精确差异和执行过的命令。
- 验证： 先跑小范围测试，再跑完整项目检查。
- 记录： 只提交已审查文件，并写清提交信息。
即使 Cursor 的模型、Agent 界面或套餐限制发生变化，这套流程仍然适用。它还能避免常见误区：因为回答看起来合理，就误以为代码已经正确。
Cursor 新手常见问题
Cursor 不了解整个项目
确认打开的是仓库根目录，索引已经完成，并避免把依赖或生成目录当成主要上下文。引用准确文件，比反复提出宽泛问题更有效。
Agent 想修改太多文件
停止当前执行并缩小任务，明确允许修改的文件、不能改变的接口，以及判断完成的具体检查。
终端命令要求审批
批准前阅读命令和工作目录。拒绝破坏性、读取凭证或无法解释用途的命令。审批是安全检查点，不是需要快速点掉的弹窗。
结果能运行，但差异看不懂
要求 Cursor 撤销无关修改，并把任务拆成更小步骤。自己无法解释的变更，不应上线或合并。
下一步学习什么
完成这次闭环后，可以通过 Cursor Rules 教程固化项目指令，再用 Cursor MCP 配置教程连接经过审核的外部工具。Windows 用户可继续查看 Cursor Windows 安装与中文设置。