Cursor

cursor准备以及基本配置

一.提前准备资源

1. Cursor 官⽹：https://cursor.com/cn/agents（⽤⼾提供，优先从官⽹下载，避免第三⽅版本存在
   安全⻛险或功能缺失）；
2. JDK 安装包（已安装可忽略）：确保环境变量配置完成（命令⾏输⼊ java -version 可验证）；
3. Android SDK 路径（必记）：打开 Android Studio → File → Project Structure → SDK
   Location，复制 SDK 安装路径（如：D:\Android\Sdk），后续配置 Cursor 安卓插件需⽤到；
4. ⽹络环境：确保⽹络通畅，⽤于下载 Cursor 安装包、插件（Cursor 部分功能依赖⽹络，AI 辅助功
   能需联⽹使⽤）。

⼆、Cursor 下载与安装

2.1 Windows 系统（最常⽤，重点讲解）

1. 打开官⽹：复制 https://cursor.com/cn/agents 到浏览器（推荐 Chrome、Edge），进⼊ Cursor中⽂官⽹，点击⻚⾯右上⻆「下载」按钮（默认识别 Windows 系统，⽆需⼿动选择）；
2. 下载安装包：等待安装包（.exe 格式，⼤⼩约200-300MB）下载完成，建议保存到桌⾯或⾮系统盘（如 D 盘），避免系统盘空间不⾜；
3. 开始安装：双击下载的 .exe 安装包，弹出安装向导，点击「下⼀步」；
4. 选择安装路径：点击「浏览」，选择安装⽬录（建议路径：D:\Cursor，避免含中⽂、空格，如"D:\软件\Cursor"会导致后续插件加载异常），点击「下⼀步」；
5. 创建桌⾯快捷⽅式：勾选「创建桌⾯快捷⽅式」（⽅便后续快速启动），点击「下⼀步」；
6. 开始安装：点击「安装」，等待安装完成（约1-2分钟，期间不要关闭安装窗⼝）；
7. 完成安装：安装完成后，勾选「运⾏ Cursor」，点击「完成」，此时 Cursor 会⾃动启动，安装步骤结束。注意事项：若安装过程中弹出"权限不⾜"提⽰，右键点击安装包，选择「以管理员⾝份运⾏」；若安装后⽆法启动，检查安装路径是否含中⽂、空格，重新安装到纯英⽂路径下。

2.2 macOS 系统

1. 打开官⽹ https://cursor.com/cn/agents，点击右上⻆「下载」，系统会⾃动识别 macOS 系统，
   下载 .dmg 格式安装包；
2. 下载完成后，双击 .dmg 安装包，弹出安装窗⼝（显⽰ Cursor 图标和 Applications ⽂件夹）；
3. 拖动 Cursor 图标到 Applications ⽂件夹中，等待复制完成（约1分钟）；
4. 启动 Cursor：打开「启动台」，找到 Cursor 图标，点击启动（⾸次启动可能会弹出"⽆法验证开
   发者"提⽰，按住 Control 键，点击 Cursor 图标，选择「打开」，即可正常启动）。
   注意事项：macOS 系统需开启"允许从任何来源下载的应⽤"（系统偏好设置 → 安全性与隐私 → 通⽤ → 允许从以下位置下载的应⽤ → 任何来源），若没有该选项，可通过终端输⼊命令开启（终端输⼊：sudo spctl --master-disable，输⼊密码后回⻋）。

2.3 Linux 系统（Ubuntu 为例）

1. 打开官⽹ https://cursor.com/cn/agents，点击右上⻆「下载」，选择 Linux 版本（.deb 格式，适
   配 Ubuntu；若为 Fedora/RHEL，选择 .rpm 格式）；
2. 下载完成后，打开终端，进⼊下载⽬录（如：cd ~/Downloads）；
3. 执⾏安装命令：sudo dpkg -i cursor_.deb（若为 .rpm 格式，执⾏ sudo rpm -i cursor_.rpm）；
4. 修复依赖（若出现依赖缺失提⽰）：sudo apt-get install -f，等待依赖安装完成；
5. 启动 Cursor：终端输⼊ cursor，或在应⽤列表中找到 Cursor 图标，点击启动即可。
   注意事项：Linux 系统需确保终端具有管理员权限（sudo 命令），若安装后⽆法启动，检查系统架构是否为64位，重新下载对应版本。

三.cursor基本配置

3.1 ⾸次启动初始化

1. ⾸次启动 Cursor，会弹出欢迎界⾯，选择「中⽂」（若默认是英⽂，点击右上⻆语⾔图标切换）；
2. 选择编码⻛格：安卓开发推荐选择「Java/Kotlin」，点击「下⼀步」；
3. 注册/登录 Cursor：可选择邮箱注册、Google 登录或 GitHub 登录（⾸次使⽤有14天免费试⽤期，试⽤期内可正常使⽤所有功能，后续可根据需求付费，安卓开发基础功能试⽤期内完全⾜够）；
4. 完成初始化：登录后，进⼊ Cursor 主界⾯，左侧为菜单栏，中间为编辑区，右侧为 AI 助⼿⾯板
   （默认开启，可关闭），初始化完成。

3.2 界⾯汉化（若默认英⽂，必做）

Cursor ⽀持中⽂界⾯，若启动后为英⽂，按以下步骤汉化，适配中⽂使⽤习惯：

1. 打开扩展⾯板：使⽤快捷键 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS），或点
   击左侧边栏的「扩展」图标（⽅块形状）；
2. 搜索并安装中⽂插件：在扩展搜索框中输⼊「Chinese (Simplified) Language Pack」，选择下载
   量最⾼、由 Microsoft 发布的插件，点击「安装」；
3. 配置语⾔：安装完成后，按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），打
   开命令⾯板，输⼊「Configure Display Language」并回⻋；
4. 选择中⽂：在弹出的语⾔列表中选择「中⽂（简体）」，系统会提⽰「重启 Cursor 以应⽤更
   改」；
5. 重启 Cursor：关闭 Cursor 后重新启动，界⾯即可切换为中⽂，包括菜单、提⽰信息和设置选项。
   注意事项：若⽆法搜索到中⽂插件，检查⽹络是否通畅，或⼿动下载 .vsix 格式插件（从 VS Code 官⽅
   插件市场下载），通过「扩展 → 安装来⾃ VSIX 的扩展」导⼊安装。

3.3 基础编辑器配置（适配安卓开发编码习惯）

打开 Cursor 「设置」（快捷键 Ctrl+, 或点击左下⻆「设置」图标），修改以下核⼼配置，提升编码体验：

1. 字体设置：搜索「字体」，设置「字体」为「Consolas」或「JetBrains Mono」（安卓开发常⽤
   字体，清晰易读），「字体⼤⼩」设为14-16（根据个⼈习惯调整），「⾏⾼」设为1.5；
2. 缩进设置：搜索「缩进」，设置「制表符⼤⼩」为4，「缩进⼤⼩」为4，勾选「将制表符转换为空格」（安卓开发规范，避免缩进混乱）；
3. ⾃动保存：搜索「⾃动保存」，选择「延迟后⾃动保存」，延迟时间设为1000ms（1秒），避免忘记保存代码；
4. 显⽰⾏号：搜索「⾏号」，勾选「显⽰⾏号」（安卓开发调试代码时，⾏号⾄关重要）；
5. 主题设置：搜索「主题」，选择「浅⾊主题」或「深⾊主题」（推荐深⾊主题，⻓时间编码护眼，如「One Dark Pro」，需在扩展中搜索安装）。

配置完成后，点击设置⻚⾯右上⻆「保存」，⽆需重启，配置⽴即⽣效。

*****************************cursor进阶

一、📝 Prompt（提示词）------ 与 AI 沟通的语言

1. 什么是 Prompt？

Prompt 是你向 Cursor 输入的自然语言指令，决定 AI 如何理解你的需求并生成代码。对 Android 开发来说，写好 Prompt 就是写好需求文档。

2. Android 开发中的 Prompt 技巧

基础 Prompt（不推荐 ❌）

"写一个登录页面"

→ 太模糊，AI 会按默认方式生成，可能不符合你的技术栈

进阶 Prompt（推荐 ✅）

**上下文**：这是一个电商应用的用户登录功能
**技术栈**：MVVM + Jetpack Compose + Kotlin + Hilt
**具体需求**：
1. 包含手机号/密码输入
2. 包含"记住密码"复选框
3. 登录后跳转到首页
4. 使用 ViewModel 管理状态
5. 使用 Kotlin Flow 处理异步
6. 添加输入验证（手机号格式、密码长度）
7. 包含加载状态和错误提示

**代码要求**：
- 使用 Material Design 3 组件
- 遵循 Clean Architecture
- 添加必要的注释
- 使用 Kotlin 协程
- 包含基本错误处理

Android 专用 Prompt 模板

// 页面生成模板
"创建一个 {页面名称} 页面，使用 {技术栈}，功能包括 {功能列表}"

// 示例：
"创建一个商品详情页，使用 MVVM + Compose，功能包括：
- 商品图片轮播
- 商品基本信息展示
- 规格选择器
- 购物车操作按钮
- 相关商品推荐
- 使用 ViewModel 管理状态
- 支持深色模式
- 添加页面状态（加载中、成功、失败）"

// 架构生成模板
"为 {功能模块} 生成 {架构模式} 代码结构，包含：
- 数据层（Repository, DataSource）
- 领域层（UseCase）
- 表现层（ViewModel, UI）
- 依赖注入配置"

// 调试模板
"分析这段崩溃日志，找出原因并提供修复方案：
{粘贴崩溃堆栈}"

3. Prompt 进阶技巧

// 1. 使用 @ 引用文件
指令："参考 @LoginViewModel.kt 的风格，创建一个 UserProfileViewModel"

// 2. 多文件协同操作
指令："修改 @MainActivity.kt 中的启动逻辑，使其先检查登录状态，
如果未登录则跳转到 @LoginActivity.kt"

// 3. 使用代码块提供上下文
指令：

基于现有的网络层代码：
@ApiService.kt
@RetrofitClient.kt

添加一个新的商品搜索接口，参数包括：
- keyword: String
- page: Int
- pageSize: Int
返回类型为 ProductSearchResponse
// 4. 分步骤指令
指令：
"第一步：创建一个 Product 数据类
第二步：创建 ProductRepository
第三步：创建 ProductViewModel
第四步：创建 ProductListScreen"

二、🤖 Agent 模式------你的自动化编程搭档

1. Agent 在 Android 开发中的实际应用

场景 1：一键创建功能模块

// 指令："创建用户模块，包含注册、登录、个人中心三个页面"
→ Agent 执行：
1. 创建 feature-user 模块
2. 生成注册页 (RegisterScreen.kt + RegisterViewModel.kt)
3. 生成登录页 (LoginScreen.kt + LoginViewModel.kt)  
4. 生成个人中心页 (ProfileScreen.kt + ProfileViewModel.kt)
5. 创建 UserRepository.kt
6. 创建 UserUseCase.kt
7. 添加模块间依赖

场景 2：大规模代码重构

// 指令："将项目中的所有 LiveData 迁移到 StateFlow"
→ Agent 执行：
1. 扫描所有 .kt 文件中的 LiveData
2. 替换为 StateFlow 和 State
3. 更新 ViewModel 中的暴露方式
4. 更新 Activity/Fragment/Composable 中的观察代码
5. 修改 import 语句
6. 运行测试验证

场景 3：依赖升级

// 指令："升级项目的 Kotlin 版本到 1.9.0，Compose 到 1.5.0"
→ Agent 执行：
1. 更新根 build.gradle.kts 中的 Kotlin 版本
2. 更新 Compose 相关版本
3. 检查并更新不兼容的依赖
4. 同步 Gradle
5. 修复可能的编译错误

2. Agent 的限制与注意事项

// 谨慎使用的场景：

// ❌ 过于复杂的业务逻辑
"实现一个完整的推荐算法"
→ AI 可能不理解具体业务规则

// ❌ 安全性敏感的操作
"修改密钥存储逻辑"
→ 可能引入安全漏洞

// ❌ 性能关键代码
"优化图片加载的核心缓存逻辑"
→ 需要人工深度优化

// ✅ 适合 Agent 的场景：
- 生成样板代码
- 代码格式化和重构
- 依赖管理和升级
- 单元测试生成
- 简单功能实现

三.MCP配置

https://cursor.com/cn/docs/mcp#mcp

1.什么是 MCP？

Model Context Protocol (MCP) 是一个开源协议，用来把 AI 应用（如 Cursor）和外部系统连在一起。可以把它理解成「AI 的 USB-C」：

AI 能通过 MCP 连接：

• 数据源：本地文件、数据库等
• 工具：搜索引擎、计算器、Git 等
• 工作流：专用提示、自定义流程等

这样 Cursor 可以直接用这些能力，而不需要你反复口头描述项目结构或手动复制粘贴。

2.在 Cursor 里能做什么？

Tools（工具）：AI 可以调用你配置的 MCP 工具（如 git status、git diff 等）

Resources（资源）：读取结构化数据（文档、配置等）

Prompts：使用预定义提示模板

Roots：限定可访问的目录或 URI 范围

3.配置gitee

三.四种工作模型

1. 🤖 Agent 模式（全能执行者）

这是 Cursor 中最强大、最常用的模式，相当于一个全栈工程师。

• 核心特点：主动、自动、修改文件。它拥有最高的权限，可以读取、修改代码，甚至执行终端命令。
• 适用场景：
  (1)实现新功能：比如你说"帮我实现基于 MVVM 架构的登录页面"，它会自动创建 ViewModel、Repository、布局文件，并可能运行编译命令。
  (2)大规模重构：比如"把所有 ButterKnife 换成 ViewBinding"，它会跨文件自动修改注解和初始化逻辑。
  (3)代码生成：生成样板代码、单元测试等。
• 安卓开发示例：你告诉它"生成一个 Jetpack Compose 的商品详情页，包含 ViewModel 和 Repository 接口定义"，它会直接生成 .kt文件并写入磁盘 。
• 风险：因为它会直接改代码，如果指令模糊，可能会引入不兼容的修改（比如修改了 build.gradle版本导致编译失败），所以执行后一定要审查 Git Diff 。

2. 📝 Plan 模式（架构设计师）

这个模式是 Cursor 2.x 版本重点优化的功能，主要用于规划。

• 核心特点：只规划，不执行（或等你批准后再执行）。它会根据需求生成详细的实施步骤，像写任务清单一样。
• 适用场景：
  （1）需求复杂：当你有一个大需求（如"接入微信支付 SDK 并处理回调"）时，先让它列出来要修改哪些文件、涉及哪些 Gradle 依赖、需要处理哪些异常。
  （2）方案评审：它可以生成 Mermaid 图表（如类图、流程图）来可视化架构，帮助你确认方案是否可行。
• 安卓开发示例：你输入"做一个离线缓存的图片加载模块"，它会列出步骤："1. 创建 CacheInterceptor；2. 配置 OkHttp 缓存策略；3. 集成 Glide 或 Coil；4. 定义接口..." 。
• 优势：避免 Agent 模式"一股脑乱改"，让你在动手前看清蓝图，适合大项目中的关键改动 。

3. 🐞 Debug 模式（专职修 Bug）

这是 Cursor 推出的专门应对疑难杂症的调试模式。

• 核心特点：聚焦问题定位与修复。它会分析报错信息、日志、堆栈跟踪，提供系统化的修复建议。
• 适用场景：
  （1）编译报错：Android Studio 报错时，直接把错误信息丢给它。
  （2）运行时崩溃：比如空指针异常、ANR（应用无响应）。
  （3）日志分析：结合 Logcat 输出，它能帮你找出逻辑漏洞。
• 安卓开发示例：你的应用在启动时崩溃，报 NullPointerException，你用 Debug 模式让它分析，它会告诉你"在 MainActivity 第 45 行 user.getName()为空，建议增加空值判断" 。
• 能力：Cursor 2.2 版本的 Debug 模式支持自动插桩日志、分析变量执行路径，甚至生成最小化可验证的修复方案 。

4. ❓ Ask 模式（知识问答员）

这是最安全、最基础的模式，相当于一个只读的 AI 助手。

• 核心特点：只回答问题，不修改代码。它的权限仅限于读取和搜索，不会触碰你的源码。
• 适用场景：
  （1）代码理解：问"这段代码是干什么的？"或"这个 Kotlin 扩展函数的用法"。
  （2）技术选型：问"Android 中 Room 和 SharedPreferences 选哪个？"。
  （3）学习：问"Jetpack Compose 的生命周期是什么？"。
• 安卓开发示例：你看到一个陌生的注解 @Parcelize，问 Ask 模式，它会解释这是 Kotlin Android Extensions 的语法糖，用于将对象序列化 。
• 优势：零风险，适合在不确定改动后果时先"查资料" 。

最佳工作流（黄金组合）：

Ask 模式：先问清楚需求或理解现有代码（比如"这个项目用了哪个网络库？"）。

Plan 模式：制定详细方案（比如"我要加一个功能，需要改 5 个文件，步骤是..."）。

Agent 模式：执行修改（让它按 Plan 去生成代码）。

Debug 模式：如果报错，用它来修复。

Ask 模式：修改完后，让它检查代码是否有优化空间 。