官方教程中文版入门、安装与模型
入门、安装与模型
Cursor 入门层：产品定位、快速开始、安装迁移、模型用量和插件边界。
这一组先解决 Cursor 的基础层：它是什么、怎么装、怎么迁移、第一天怎么做一个安全小改动、模型用量怎么核验、插件和 Marketplace 怎么控风险。
阅读方式：不要跳过快速开始。Cursor 的后续 Agent、Rules、MCP、CLI、Cloud Agent 都建立在“低风险项目里能解释代码库、做小改动、审 diff、跑检查”这个闭环上。
学习路径
flowchart TD
Start["入门层"] --> Position["产品定位"]
Position --> Quick["快速开始"]
Quick --> Install["安装与迁移"]
Install --> Models["模型、价格与用量"]
Install --> Plugins["插件与 Marketplace"]
Models --> Agent["进入 Agent 工作流"]
Plugins --> AgentCursor 产品定位
理解 Cursor 是 AI editor and coding agent，而不是普通 IDE 插件。
快速开始
从安装登录到解释代码库、小改动、review diff 和 Plan Mode。
安装与迁移
从官方安装、VS Code 迁移和 JetBrains 迁移文档梳理安全迁移路径。
模型、价格与用量
理解 usage pools、Auto、Composer、API pool、Max Mode 和团队计费边界。
插件与 Marketplace
区分 extensions 和 plugins，理解团队 marketplace 与 required 插件风险。
入门层验收
读完这一组，至少能做到：
- 解释 Cursor 的两层身份：AI editor 和 coding agent。
- 在低风险项目里跑通 first useful change。
- 从 VS Code 或 JetBrains 迁移时不照搬高风险配置。
- 知道模型、价格、usage pools 和 Max Mode 去哪里核验。
- 区分 extension、plugin、team marketplace 和 required plugin。
建议练习
入门层不建议只读页面。找一个低风险 repo，按这个顺序练：
- 让 Cursor 解释项目结构，不改文件。
- 选择一个小 bug 或文案改动，让 Agent 先给 plan。
- 审查 plan 后再允许它修改。
- 看 diff，确认没有 unrelated changes。
- 跑对应测试或手动检查。
- 记录哪些信息应该写进 Rules。
这一轮练习能把安装、模型、上下文、diff、终端和验证串起来。后续进入 Agent 工作流时，你就不是在“试功能”，而是在已有闭环上增加能力。
不要跳过的边界
模型和用量页面只给核验方法，不替代官方价格页。安装迁移也不是把旧编辑器配置全搬过来，尤其是插件、token、shell profile、代理和团队策略。先用默认安全配置跑通，再逐步迁移高权限能力。
入门阶段的目标是建立安全默认值：低风险项目、可回退 diff、明确验证命令、最少插件、最少外部访问。后面所有高级能力都应该在这个基础上增加，而不是绕开它。
官方来源
- Cursor Documentation - 官方总览和能力地图。
- Cursor Quickstart - 官方第一天路径。
- Cursor Help Center - 安装、迁移、插件和排障入口。
- Cursor llms.txt - 官方文档索引。