**快速答案：**第一次使用 Cursor，不需要先研究所有模型和高级功能。完成下载安装、导入编辑器配置、打开一个 Git 项目，再依次体验 Tab、行内编辑和 Agent，就已经能够跑通核心流程。真正应该提前配置的是项目规则、忽略文件和版本控制，而不是把所有权限一次性交给 Agent。
这篇文章由旧站 2025 年的 Cursor 配置指南更新而来。旧稿里的模型名称、设置入口和产品界面已经发生变化，所以本文只保留稳定的工作方法，并以 2026 年 8 月可查的 Cursor 官方资料重新核验。
本文适合谁
- 第一次安装 Cursor，不知道应该从哪里开始；
- 从 VS Code 迁移，希望保留主题、快捷键和扩展；
- 已经能对话，但生成结果经常偏离项目；
- 想先建立一套可回滚、可检查的 AI Coding 工作流。
Cursor 是什么
Cursor 是一个带有 AI 编程能力的代码编辑器。它能读取项目文件、搜索代码、生成修改并运行终端命令。对新手来说，可以先把它理解成三个层次：
| 能力 | 适合做什么 | 建议用法 |
|---|---|---|
Tab | 补全当前正在写的代码 | 小步接受，不满意就跳过 |
| 行内编辑 | 修改选中的函数或代码块 | 明确选区和验收条件 |
| Agent | 跨文件分析、修改和运行命令 | 先计划，再修改，最后看 diff |
Cursor 官方快速入门也围绕这三项能力展开。不要一开始就让 Agent 重构整个项目，先用一个能运行测试的小仓库熟悉确认、撤销和审查流程。
第一步：下载安装
访问 Cursor 官方下载页，选择对应的 macOS、Windows 或 Linux 安装包。安装完成后首次启动，按照引导选择快捷键、主题和终端偏好即可。
已经使用 VS Code 的同学，可以在初始化过程中导入配置。Cursor 基于 VS Code 的编辑体验，常用扩展、主题和快捷键通常都能继续使用。不过涉及远程开发、企业账号或底层调试的扩展，迁移后仍应逐个验证。
安装完成后，不妨先确认三件事：
- 能否打开一个真实 Git 仓库；
- 项目的安装、测试和构建命令能否正常执行；
- 修改文件后，Git diff 是否能准确显示变化。
第二步：用一个小任务跑通核心流程
打开已有项目后，先把任务控制在一个文件或一个测试范围内。例如：
阅读 src/utils/date.ts 和对应测试。
先解释 parseDate 的输入输出和边界情况，不要修改代码。
确认后，再补充一个无效日期的测试并运行该测试文件。
这个提示词有四个关键部分：指定文件、说明目标、限制第一阶段只读、给出验证动作。相比“帮我优化这个项目”，它更容易得到可检查的结果。
完成后检查 Agent 的变更列表，再运行项目自己的测试。AI 给出的“测试通过”只能作为过程信息，最终仍要以本地命令和 diff 为准。
第三步：建立最小项目规则
项目约定不要长期藏在聊天里。Cursor 支持放在 .cursor/rules/ 下的 Project Rules，也支持根目录中的 AGENTS.md。新项目可以先从一个简短的 AGENTS.md 开始：
# Project Instructions
## Commands
- Install: pnpm install
- Test: pnpm test
- Build: pnpm build
## Engineering rules
- Use TypeScript for new source files.
- Do not edit .env or production configuration.
- Run the smallest relevant test before the full suite.
- Summarize changed files and remaining risks.
规则应该记录真实项目知识，而不是堆满“高质量、优雅、最佳实践”这类无法检查的形容词。需要按目录自动应用、手动调用或拆分多套规则时，再使用 .cursor/rules/*.mdc。详细配置可以继续阅读Cursor Rules 项目规则完整指南。
第四步：先排除不该被读取的文件
在项目根目录创建 .cursorignore，排除密钥、构建产物、大型数据和无关缓存：
.env
.env.*
!.env.example
node_modules/
.next/
dist/
coverage/
*.pem
*.key
data/private/
.cursorignore 不是权限系统。Cursor 官方安全说明把它描述为尽力阻止相关文件进入索引或 AI 请求，因此真正的密钥仍然应该放在密钥管理系统中，并通过最小权限和短期凭据控制风险。
新手最容易踩的五个坑
1. 一次给出过大的任务
“重构整个后台”没有明确边界。把任务拆成调查、计划、实现、测试四段，错误会更早暴露。
2. 把规则写成愿望清单
“代码要优雅”不能执行。应该写清文件位置、命令、禁止项和可参考的现有实现。
3. 不看 diff 就接受修改
Agent 能改多个文件，也可能顺手调整依赖和配置。每次至少检查变更文件、删除内容和新增依赖。
4. 把模型回答当成测试结果
测试必须由本地或 CI 命令执行。对于数据库迁移、权限和支付代码，还需要人工审查。
5. 把真实密钥贴进聊天
使用环境变量名和脱敏示例即可。已经泄露的密钥应立即轮换，删除聊天记录不能代替轮换。
推荐的第一周学习顺序
| 天数 | 练习目标 |
|---|---|
| 第 1 天 | 安装并完成一个单文件修改 |
| 第 2 天 | 用 Agent 补测试，检查 diff |
| 第 3 天 | 添加 AGENTS.md 或 Project Rules |
| 第 4 天 | 配置 .cursorignore，理解上下文来源 |
| 第 5 天 | 尝试一个受信任的 MCP 工具 |
常见问题
Cursor 不登录可以使用吗？
官方安装文档说明编辑器可以在未登录状态下工作，但完整 AI 功能需要账号。具体免费额度和套餐可能变化，使用前应查看 Cursor 当前价格页。
Cursor 会自动理解整个仓库吗？
它会通过搜索、索引和当前会话信息收集上下文，但“能访问”不等于“已经理解”。明确任务、提供关键入口并维护项目规则，仍然会显著提高结果质量。
新手应该先选哪个模型？
先使用 Cursor 当前推荐的自动选择或默认模型跑通流程。模型列表和价格变化很快，初学阶段更重要的是学会限定范围、检查 diff 和运行验证。
总结
Cursor 入门的重点不是背下全部功能，而是建立一个可靠循环：**明确任务，提供必要上下文，让 Agent 小步修改，检查 diff，再用测试验证。**完成这套循环后，再继续学习 Rules、MCP 和大型代码库工作流，效率会比反复切换模型更稳定。