【工具篇6】关于使用Cursor进行Android开发

2,062 阅读6分钟

因为Cursor是基于VSCode开发的,其对于Android开发的支持并不友好。所以使用Cursor进行Android开发需要进行一些基础的配置,使其看起来更加友好,但还是要同时开启两个IDE,Cursor用于编码确认,对于UI设计、需求开发、深度调试还得是Android Studio。

1 配置Cursor支持Android开发

以下先介绍Cursor相关的一些Android配置

1.1 Cursor 安装插件

打开 Cursor → 点击左侧「Extensions」(图标)

搜索并安装以下插件:

  1. Kotlin 语言支持(若使用 Kotlin 开发,JetBrains 官方插件,提供 Kotlin 语法高亮和补全):
    在 Cursor 扩展商店搜索 Kotlin(发布者:fwcd),点击安装。 image.png

  2. Java 扩展(若使用 Java 开发):
    搜索 Extension Pack for Java(发布者:Microsoft),包含 Java 语法高亮、调试等功能。 image.png

  3. Android 扩展(非官方插件,增强 Android 文件识别): 搜索 Android(发布者:adelphes),提供 ADB 集成、布局预览、日志查看等工具。 image.png

  4. XML 扩展(Android 布局文件支持): 搜索 XML(发布者:redhat),Android 布局文件支持。 image.png

  5. Gradle Tasks 扩展(构建工具支持): 搜索 Gradle Tasks(发布者:richardwillis),构建工具支持。 image.png

1.2 Android Studio 安装插件

  1. Switch2Cursor快速切换到Cursor:
    image.png

安装完成后,重启AndroidStudio生效

2 Cursor 上下文

关于Cursor的功能和使用,建议还是查看官网文档,介绍会更加详细

2.1 代码库索引

当你打开项目时,Cursor 会开始学习你的代码。这称为“索引”,它让 AI 建议更准确。

Cursor 会为除 忽略文件(如 .gitignore.cursorignore)中列出的文件外的所有文件建立索引。

点击 Show Settings 以:

  • 为新仓库启用自动索引
  • 配置要忽略的文件

2.2 .cursorignore 配置

Cursor 会读取并索引你的项目代码库以支撑其功能。使用根目录中的 .cursorignore 文件控制 Cursor 可访问的目录和文件。

Cursor 会在以下场景阻止访问 .cursorignore 中列出的文件:

对于不需要索引的文件,或有隐私秘钥等信息的文件,可以通过.cursorignore文件将其排除

操作路径:Open Settings -> Indexing & Docs -> Ignore Files in .cursorignore -> Edit
配置示例如下:

# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
build/
.gradle/
*.apk

建议直接用Cursor生成即可

2.3 配置 MCP

Model Context Protocol(MCP) 使 Cursor 能连接到外部工具和数据源。

在 mcp.json 的值中使用变量。Cursor 会在这些字段中解析变量:commandargsenvurl 和 headers

支持的语法:

  • ${env:NAME} 环境变量
  • ${userHome} 你的主目录路径
  • ${workspaceFolder} 项目根目录(包含 .cursor/mcp.json 的文件夹)
  • ${workspaceFolderBasename} 项目根目录名称
  • ${pathSeparator} 和 ${/} 操作系统路径分隔符

2.3.1 安装Node.js运行环境

  1. nodejs.org/zh-cn 下载安装Node.js

image.png

如上图所示,直接点击【Windows安装程序】下载安装即可,安装完成可通过提示的命令检查,如下所示

image.png

2.3.2 sequential-thinking 配置

github.com/modelcontex… 中选择所需的MCP进行安装,详见如下:

选择【MCP&Integrations】——【New MCP Server】进行添加 image.png

sequential-thinking为例,访问sequential-thinking,可以看到其配置如下: image.png

  • sequential-thinking: 这是MCP服务器的名称
  • command: 使用 npx 命令来运行
  • args: 参数数组,-y 表示自动确认安装,后面是包名

配置完成后需要重启Cursor编辑器,MCP服务器才会生效。配置完成后,在 Cursor 界面左侧通常会有一个状态指示灯,绿色表示 MCP 连接成功,红色表示失败。如果指示灯为红色,需要检查配置信息是否正确。

2.3.3 多个MCP配置

若需要再添加新的MCPFigma-Context-MCP,访问Figma-Context-MCP,可以看到其配置如下:

image.png 添加到mcp.json中,如下所示:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "Framelink Figma MCP": {
      "command": "npx",
      "args": [
        "-y",
        "figma-developer-mcp",
        "--figma-api-key=YOUR-FIGMA-API-KEY",
        "--figma-team-id=YOUR-TEAM-ID",
        "--stdio"
      ]
    }
  }
}

这里建议可以直接让Cursor帮你配置即可

2.4 @符号

使用方向键浏览建议,按 Enter 进行选择。若建议为 Files 等类别,列表将筛选为仅显示该类别中最相关的项目。

3 Agent

Agent 是 Cursor 的助手,能独立完成复杂编码任务、运行终端命令并编辑代码。可在侧边栏按 Cmd+I 打开。

3.1 选项卡

按 Cmd+T 新建标签页。每个标签页都会分别保留会话历史、上下文和模型选择。

管理标签页

  • 使用 Cmd+T 创建新标签页。每个标签页都会从全新的对话开始,并保持各自的上下文。
  • 点击标签页标题或使用 Ctrl+Tab 在标签页间切换。
  • 首条消息发送后会自动生成标签页标题。右键点击标签页标题即可重命名。

3.2 导出

如何导出

  1. 进入要导出的聊天
  2. 点击菜单 → “导出聊天”
  3. 将文件保存到本地

3.3 命令

自定义命令可让你创建可复用的工作流,并可在聊天输入框中通过简单的“/”前缀触发。这些命令有助于在团队内标准化流程,并提升常见任务的效率。

创建命令
如下图所示,在Chat中输入"/",点击Create Command即可创建你需的命令

image.png

  1. 在项目根目录创建一个 .cursor/commands 目录
  2. 添加具有描述性名称的 .md 文件(例如:review-code.mdwrite-tests.md
  3. 使用纯 Markdown 编写内容,说明该命令应执行的任务
  4. 当你输入 / 时,命令会自动出现在聊天中

4 Cursor Rules

规则为 Agent 和 Inline Edit 提供系统级指令。它们为你的项目提供持久化的上下文、偏好设置或工作流。

Cursor 支持四种类型的规则:

  1. 项目规则: 存储在 .cursor/rules 中,受版本控制,作用范围限定在你的代码库。
  2. 用户规则: 作用于整个 Cursor 环境。在设置中定义并始终生效。
  3. AGENTS.md: 以 Markdown 格式编写的 Agent 指令。是 .cursor/rules 的简化替代方案。
  4. .cursorrules(旧版): 仍受支持,但已弃用。请改用项目规则。

4.1 配置 Cursor Rules

大型语言模型在不同次生成之间不会保留记忆。规则在提示层级提供持久且可复用的上下文。

应用后,规则内容会被添加到模型上下文的开头。这为 AI 在生成代码、理解编辑或协助工作流程时提供一致的指导。

.cursorrules规则名称只能包含小写字母、数字和连字符,如:project-rule,如果命名不成功,可以让cursor生成 将上面的 alwaysApply 设置为 true ,那么在问答时这个规则会一直被作为上下文提供给 AI

项目规则

操作路径:Open Settings -> Rules & Memories -> Project Rule -> Add Rule
配置示例如下:

---
description:
globs:
alwaysApply: true
---
永远用中文进行问答

最佳实践#

优质规则应当聚焦、可执行、范围清晰。

  • 将规则控制在 500 行以内
  • 将大型规则拆分为多个可组合的小规则
  • 提供具体示例或引用的文件
  • 避免含糊其辞。像清晰的内部文档那样撰写规则
  • 在聊天中重复使用相同提示时复用规则

用户规则

用户规则是在 Cursor Settings → Rules 中定义的全局首选项,适用于所有项目。它们为纯文本,适合用于设置偏好的沟通风格或编码规范:

请以简洁的风格回复。避免不必要的重复或冗余语言。