Cursor + Android Studio 插件完整方案

Cursor + Android Studio 插件完整方案

先分清两个核心场景:

  1. Android Studio 内嵌入 Cursor AI(Cursor CLI Terminal 插件,直接在 AS 侧边栏用 Cursor 对话)
  2. Cursor 编辑器适配 Android 项目(在 Cursor 里写安卓代码,搭配 Android Studio 编译调试)
  3. MCP 互通插件:让 Cursor 读取 Android Studio 完整项目上下文

一、Android Studio 安装 Cursor CLI Terminal(主流方案)

1. 前置:本地安装 Cursor 客户端

官网下载:https://cursor.com Windows/macOS/Linux 安装完成后,验证 agent:

bash

# mac/linux终端执行 cursor-agent --version

输出版本号即正常;Windows 在 CMD/PowerShell 执行同样命令。

2. AS 安装插件

  1. 打开 Android Studio → File → Settings(mac:Android Studio → Preferences)
  2. Plugins → Marketplace 搜索:Cursor CLI Terminal(ID:28562)
  3. Install → 重启 Android Studio
  4. 打开 AI 面板:顶部菜单Tools → Focus Cursor CLI Terminal侧边栏会出现 Cursor 对话窗口,不用切软件直接 AI 生成 / 改 Kotlin/Java/Compose/XML。

常见报错:找不到 cursor-agent

  • Mac zsh:添加 PATH

bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile source ~/.zprofile
  • Windows:把 Cursor 安装目录下.local/bin加入系统环境变量 PATH
  • 重启 AS 和终端重试

二、MCP Server 插件(最强互通,Cursor 读取 AS 完整项目)

插件名:MCP Server(ID:26071)

作用

Cursor 可以读取 Android Studio 完整工程、Gradle 依赖、布局资源、Logcat 日志,AI 上下文更精准,支持跨文件批量修改 ViewModel/Compose 页面。

安装步骤

  1. AS Plugins 搜索MCP Server安装重启
  2. AS 右下角启动 MCP 服务(默认本地端口)
  3. 打开 Cursor 编辑器 → 设置 MCP 客户端,连接 AS 本地服务
  4. 在 Cursor 里@整个项目提问,AI 能感知安卓全工程结构

三、Cursor 编辑器安装 Android 开发插件(在 Cursor 写安卓代码)

Cursor 基于 VSCode 内核,扩展市场安装这几个插件:

  1. Extension Pack for Java:Java 语法、调试、Gradle 基础支持
  2. Android(adelphes):ADB、布局 XML 识别、日志查看
  3. Gradle Tasks:执行 build/assembleDebug 任务
  4. Kotlin Language Server:Kotlin/Compose 语法补全、静态检查
  5. Android Studio Lite:一键启动模拟器、安装 APK、管理 AVD

Cursor 安卓开发快捷键

  • Ctrl+L:AI 对话,解释代码 / 查 Android API 问题
  • Ctrl+K:选中代码批量重构、生成 Compose、修复空指针 / 生命周期 bug
  • /create android app:指令快速生成空白安卓工程模板

四、Switch2Cursor 切换插件(轻量)

适合不想内嵌面板、只想一键跳转: AS Marketplace 搜索Switch2Cursor,安装后右键文件 / 目录,直接用 Cursor 打开当前项目,双向快速切换。

五、两种工作流对比推荐

方案 A(纯 Android Studio 用户):Cursor CLI Terminal

  • 优点:不用双开软件,调试、预览、模拟器全在 AS,侧边 AI 随用随开
  • 适合:日常写页面、修复崩溃、生成布局、查询安卓 API

方案 B(重度 AI 重构):Cursor 编辑器 + AS MCP 插件

  • 优点:Cursor Agent 可批量修改多文件(改 Repository 同步更新 UI 层),代码库全局问答更强
  • 适合:架构重构、新增完整业务模块、复杂 Compose 分页 / 数据流

六、Android 开发常用 Cursor 指令示例

  1. 生成 Compose 列表:用Paging3写一个Compose LazyColumn,Retrofit作为数据源,加载状态占位+错误重试
  2. 修复 Fragment 生命周期 NPE:分析这段代码为什么onResume空指针,给出修复方案并加上viewModel生命周期保护
  3. Gradle 优化:优化app模块build.gradle,开启编译缓存、缩减APK体积、配置签名
  4. 布局转换:把这个XML布局转换成Jetpack Compose代码,适配深色模式

七、常见问题

  1. 插件无 AI 响应:确认本地 cursor-agent 可运行,关闭 AS 代理冲突
  2. Cursor 识别不到 Android 资源:安装 Android 扩展,配置 ANDROID_SDK_ROOT 环境变量
  3. Gradle 报错:在 Cursor 执行./gradlew sync同步项目索引

转自:https://www.doubao.com/thread/x0683e1ee60c5883d9359c06888e01a4a