跳到主要内容

使用 Cursor 进行 Android 开发：设置与技巧

Android 开发传统上与 Android Studio 紧密绑定，这是 Google 基于 IntelliJ IDEA 构建的官方 IDE。Cursor 作为具备 AI 功能的 VS Code 分支，提供了一种不同的体验 —— 它用强大的 AI 辅助替代了一些 Android 专用工具。本指南介绍如何在 Cursor 中设置 Android 开发环境、何时使用它有意义，以及 Android Studio 仍然不可或缺的地方。

Android Studio 与 Cursor：得失分析​

在切换到 Cursor 进行 Android 开发之前，请先了解其中的权衡：

功能Android StudioCursor
布局编辑器（XML 可视化）有无
模拟器集成内置外部
Gradle 同步与构建原生仅终端
Logcat 查看器内置无
APK 分析器内置无
数据库检查器内置无
AI 代码辅助基础（Gemini）高级（Claude、GPT）
自然语言聊天无有
Composer 多文件编辑无有
VS Code 扩展无有
可自定义快捷键有限完全

这个决定不是非黑即白的。许多开发者使用 Cursor 编写代码，使用 Android Studio 进行构建、调试和运行模拟器。

在 Cursor 中设置 Android 开发环境​

1. 安装必要的扩展​

Cursor 支持 VS Code 扩展。对于 Android 开发，请安装以下扩展：

  1. 打开 Cursor
  2. 前往 扩展（Ctrl+Shift+X / Cmd+Shift+X）
  3. 搜索并安装：
    • Kotlin Language，由 mathiasfrohlich 提供 —— 语法高亮和基础 IntelliSense
    • Kotlin，由 fwcd 提供 —— 高级 Kotlin 支持（二选一）
    • Android iOS Emulator，由 DiemasMichiels 提供 —— 模拟器启动器
    • Gradle Language Support —— 用于 build.gradle 和 settings.gradle 文件
    • XML Tools —— 用于 Android manifest 和布局文件
// 在 .vscode/extensions.json 中推荐的扩展
{
  "recommendations": [
    "mathiasfrohlich.kotlin",
    "vscjava.vscode-gradle",
    "redhat.vscode-xml",
    "diemasmichiels.emulator"
  ]
}

2. 在 Cursor 中打开你的 Android 项目​

你可以像打开任何其他文件夹一样在 Cursor 中打开 Android 项目：

# 导航到你的项目
cd ~/Projects/MyAndroidApp

# 在 Cursor 中打开
cursor .
Gradle 文件

Cursor 可以编辑 .gradle 和 .kts 文件，但无法像 Android Studio 那样同步 Gradle 或解析依赖项。你需要从终端运行 Gradle 命令。

3. 配置 Gradle 构建任务​

为常见的 Gradle 操作设置 VS Code 任务：

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Build Debug APK",
      "type": "shell",
      "command": "./gradlew",
      "args": ["assembleDebug"],
      "group": {
        "kind": "build",
        "isDefault": true
      }
    },
    {
      "label": "Run Tests",
      "type": "shell",
      "command": "./gradlew",
      "args": ["test"]
    },
    {
      "label": "Install Debug APK",
      "type": "shell",
      "command": "./gradlew",
      "args": ["installDebug"]
    },
    {
      "label": "Clean Build",
      "type": "shell",
      "command": "./gradlew",
      "args": ["clean"]
    }
  ]
}

使用 Ctrl+Shift+B（macOS 上为 Cmd+Shift+B）运行任务。

在 Cursor 中设置 Gradle​

Gradle 是 Android 构建的支柱。在 Android Studio 中，Gradle 同步是自动的。在 Cursor 中，你需要手动管理。

常用 Gradle 命令​

# 构建项目
./gradlew build

# 构建 debug APK
./gradlew assembleDebug

# 构建 release APK
./gradlew assembleRelease

# 运行单元测试
./gradlew test

# 运行仪器测试
./gradlew connectedAndroidTest

# 清理构建产物
./gradlew clean

# 查看所有可用任务
./gradlew tasks

Gradle Wrapper 问题​

如果 wrapper 脚本没有可执行权限：

chmod +x gradlew

在 Windows 上，使用 gradlew.bat 代替 ./gradlew。

依赖管理​

当你向 build.gradle 或 build.gradle.kts 添加依赖时，Cursor 不会自动同步。你必须运行：

./gradlew build

或者使用 Gradle daemon 来加快后续构建速度：

./gradlew --daemon build
Gradle Daemon

Gradle daemon 会驻留在内存中，显著加快构建速度。通过在 ~/.gradle/ 中创建 gradle.properties 文件并设置 org.gradle.daemon=true 来默认启用它。

模拟器集成​

Cursor 没有像 Android Studio 那样的内置模拟器。你有两个选择：

选项 1：从终端启动模拟器​

# 列出可用模拟器
emulator -list-avds

# 启动特定模拟器
emulator -avd Pixel_7_API_34

将其添加为 VS Code 任务以便快速访问：

{
  "label": "Launch Emulator",
  "type": "shell",
  "command": "emulator",
  "args": ["-avd", "Pixel_7_API_34"]
}

选项 2：使用模拟器扩展​

Android iOS Emulator 扩展（由 DiemasMichiels 开发）为 Cursor 的状态栏添加了模拟器启动器。

  1. 安装扩展
  2. 点击状态栏中的模拟器图标
  3. 从下拉菜单中选择你的 AVD

选项 3：保持 Android Studio 打开​

许多开发者只是保持 Android Studio 运行以使用模拟器和 Logcat，同时在 Cursor 中编辑代码。这是最可靠的方法。

Kotlin 和 Java 支持​

Cursor 对 Kotlin 和 Java 的处理都很好，但由于社区工具的支持，Kotlin 的支持更强。

Kotlin​

  • 使用 Kotlin 扩展可实现语法高亮
  • Cursor Tab 自动补全对 Kotlin 惯用法很有效
  • AI 聊天理解 Kotlin 协程、Flow 和 Compose

Kotlin 的示例提示：

"用 Kotlin 创建一个 ViewModel，使用 Retrofit 获取用户数据
并将其暴露为 StateFlow。处理加载和错误状态。"

Java​

  • Cursor 中的 Java 支持非常出色（VS Code 拥有成熟的 Java 扩展）
  • 你可以安装 Microsoft 的 Extension Pack for Java 以获得完整的 IDE 功能
  • Cursor 的 AI 对 Java 和 Kotlin 同样有效
// 完整的 Java 支持
{
  "recommendations": [
    "vscjava.vscode-java-pack"
  ]
}

Android Jetpack Compose​

Jetpack Compose 是 Cursor 大放异彩的地方。由于 Compose 是纯代码（没有 XML 布局），整个 UI 都可以在 Cursor 中编写和优化：

@Composable
fun UserProfileCard(user: User) {
    Card(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp),
        elevation = CardDefaults.cardElevation(defaultElevation = 4.dp)
    ) {
        Column(modifier = Modifier.padding(16.dp)) {
            Text(text = user.name, style = MaterialTheme.typography.headlineSmall)
            Text(text = user.email, style = MaterialTheme.typography.bodyMedium)
        }
    }
}

Cursor 可以有效地生成、重构和解释 Compose 代码，因为它是纯 Kotlin。

双 IDE 工作流​

根据社区反馈，Android 开发最高效的设置是：

任务工具原因
编写 Kotlin/Java 代码CursorAI 辅助，更好的编辑体验
编辑 XML 布局两者皆可Cursor 可用；Android Studio 有预览
构建和部署Android Studio可靠的 Gradle 同步和模拟器
带断点的调试Android Studio更优秀的调试器和 Logcat
Compose UI 开发Cursor纯代码，不需要预览
性能分析Android StudioCPU/内存/网络分析器

推荐的工作流​

  1. 在两个 IDE 中打开项目
  2. 在 Cursor 中编辑代码 —— 使用聊天获取解释，使用 Composer 进行重构
  3. 在 Android Studio 中构建 —— 点击运行按钮部署到模拟器
  4. 在 Android Studio 中调试 —— 使用 Logcat 和调试器
  5. 从任一 IDE 提交 —— 两个 IDE 都通过文件系统检测文件更改

局限性​

Cursor 在 Android 开发中无法做到的事​

局限性影响变通方案
没有布局编辑器无法可视化编辑 XML手动编辑 XML 或使用 Android Studio
没有内置模拟器无法直接运行应用使用终端或保持 Android Studio 打开
没有 Logcat 查看器无法查看日志在终端使用 adb logcat 或 Android Studio
没有 APK 分析器无法检查 APK使用 Android Studio 的构建分析器
没有数据库检查器无法检查 Room 数据库使用 Android Studio 或 Stetho
Gradle 同步不自动必须手动运行构建使用终端或任务快捷方式

已知问题​

问题：Kotlin 扩展对有效代码显示错误

解决方案：VS Code 的 Kotlin 扩展不如 Android Studio 的成熟。有些错误是误报。依赖 Gradle 构建来获取真实的编译状态。

问题：Compose 预览不起作用

解决方案：Android Studio 的 Compose 预览在 Cursor 中不可用。使用模拟器或构建应用来查看 UI 更改。

问题：R.java 引用显示为未解析

解决方案：运行一次 ./gradlew build 以生成代码。Kotlin 扩展可能仍会显示警告，但代码可以编译。

最佳实践​

1. 尽可能使用 Compose​

Jetpack Compose 消除了 XML 布局编辑的需求，使 Cursor 成为 Android UI 工作更可行的主要编辑器。

2. 为常见任务创建 Shell 脚本​

自动化重复的 Gradle 命令：

#!/bin/bash
# scripts/build.sh
./gradlew clean assembleDebug && adb install app/build/outputs/apk/debug/app-debug.apk

3. 从终端使用 ADB​

学习 ADB 命令以进行快速设备交互：

# 安装 APK
adb install app/build/outputs/apk/debug/app-debug.apk

# 查看应用日志
adb logcat -s "MyAppTag:D"

# 清除应用数据
adb shell pm clear com.example.myapp

# 截图
adb shell screencap -p /sdcard/screen.png
adb pull /sdcard/screen.png

4. 利用 Cursor 的 AI 生成样板代码​

Android 涉及大量样板代码。使用 Cursor 生成：

  • RecyclerView 适配器
  • Retrofit 服务接口
  • Room 数据库实体和 DAO
  • ViewModel 工厂
  • Dagger/Hilt 模块
Cursor 提示：
"为 Todo 项生成一个 Room 数据库实体，包含 id、title、
description、dueDate 和 isCompleted 字段。包含带有 CRUD 操作的 DAO
以及一个获取已完成 todo 的查询。"

总结​

Cursor 是 Android 开发的一个可行工具，特别是对于 Kotlin 和 Jetpack Compose 项目。它不是 Android Studio 的完全替代品，但在代码编写、重构和 AI 辅助开发方面表现出色。

关键要点：

  • 安装 Kotlin 和 Gradle 扩展以获得 Cursor 中的基础 IDE 功能
  • 从终端使用 Gradle 命令 —— 没有自动同步
  • 从终端启动模拟器或使用模拟器扩展
  • 双 IDE 工作流（Cursor 编写代码，Android Studio 构建/调试）最可靠
  • Jetpack Compose 项目在 Cursor 中效果最好，因为它们是纯代码
  • 在发布前始终在 Android Studio 中验证构建

如果你的工作流严重依赖可视化布局编辑、大量调试或性能分析，Android Studio 仍然是必不可少的。对于纯代码编写和 AI 辅助，Cursor 是一个强有力的替代方案。

最后更新：2025 年 6 月