这几年我用AI辅助写Android的时间不算短了,从最开始对“AI生成代码”抱着强烈不信任,到后来自觉把它嵌入日常开发流程,这个转变来得比我自己预想的要快。说实话,AI没法一步到位替你搞定一个完整的商业App,但在Android开发这个足够复杂、模板化代码又特别多的领域里,它确实能把大量“搬砖”环节吃掉,让你把精力放到架构设计和业务逻辑上。
这篇文章打算围绕“用AI进行Android编程”这件事,把我实际跑过的流程、用过的提示词方案、踩过的坑通通整理出来。适合那些正在用Android Studio做原生开发、想引入AI辅助但不知道怎么下手的人,也适合已经在用AI但觉得生成结果不可控、想进一步优化协作方式的开发者。
1. 内容整体设计与思路拆解
1.1 AI在Android开发里到底能解决什么问题
社区里经常有人争论“AI能不能取代Android工程师”,我觉得这个问题本身问偏了。用AI写Android真正的价值,不在“取代”什么,而在于把开发里那些高度确定性的工作大幅压缩。
举个例子,创建一个RecyclerView的Adapter,放到五年前你至少要写几十行样板代码,配合DiffUtil、点击回调、空状态管理,怎么也得忙活一阵子。现在你把需求描述给AI,几秒钟就能拿到一份能编译的Kotlin文件,改动几个回调接口就能直接跑。再比如Room数据库的DAO层、Retrofit的Service接口、Compose的普通页面布局,这些都有非常成熟的语法范式和重复模式,AI在这类场景下表现得特别稳定。
我自己的体感是,AI更适合处理“高确定性+低决策量”的编码任务,比如:网络请求封装、列表适配器、数据库操作、布局骨架、单元测试模板。这类任务模式固定、边界清晰,AI生成的成功率非常高。反过来,如果任务本身涉及复杂的业务规则判断、跨模块状态同步、或者需要你基于产品语境做架构取舍,AI就会显得力不从心,甚至一本正经地给出看起来很合理但实际行不通的设计。
还有一个非常容易被忽视的价值:AI是即时可用的增量学习工具。Android生态变化速度大家有目共睹,API不断废弃、新架构组件层出。过去碰到一个生疏的API,你得翻文档、刷社区帖子;现在直接把报错信息丢给AI,它能给你解释原因并给出迁移建议,学习效率高很多。
1.2 技术选型与实际落地路径
说回项目本身。用AI做Android编程,首先要选定一条主线和一套稳定的技术栈,否则AI生成的代码会非常飘。
我在实际开发里用的组合是Kotlin + Jetpack Compose + Retrofit/OkHttp + Room + Hilt。选Compose很重要的一个原因是它和AI协作特别顺畅:Compose是声明式UI,AI生成布局时的思维方式和写普通视图代码完全不同,它更容易产出无状态的、可组合的小组件,这对后续维护特别友好。传统XML布局在AI手里也还行,但嵌套层级一多,AI经常把重量级父布局和无效约束堆在一起,到后期约束起来比较费劲。
选好了技术栈之后,一个重要动作是让AI“理解”你的项目。很多人用AI编程工具时直接上来就甩一句“帮我写一个登录页面”,得到的只能是泛泛的教学代码。真正有效的做法是:先给AI交代清楚项目背景、用的框架、SDK版本、最低支持版本、包名规则,再让它在这些约束条件下生成代码。
我在Android Studio里日常打开一个叫“项目上下文”的备注文件,里面写着:
- 项目类型:原生Android,Kotlin语言
- UI框架:Jetpack Compose,Material 3
- 最低SDK:26,Target SDK:34
- 网络层:Retrofit2 + OkHttp + kotlinx.serialization
- 依赖注入:Hilt
- 数据库:Room
- 架构模式:MVVM + Repository
每次和AI协作之前,我会把这份上下文粘进对话里。别嫌麻烦,这个步骤能让AI生成结果的准确率翻倍。你要知道,AI本身并不会“记住”你项目的细节,它只是读到你给的提示词后做模式匹配。上下文越接近真实项目,生成结果就越接近可直接落地的代码,后续调整成本也越低。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心细节解析与实操要点
2.1 让AI先画骨架:需求拆解与提示词设计
很多人觉得AI写代码不可控,其中一个核心原因就是提问方式太笼统。“给我写个笔记App”这种需求,人听了都要发懵,何况是模型。想让AI输出能用、能跑、能维护的Android代码,提示词设计是最关键的技术活。
一个好的提示词至少要有这几个要素:
- 功能描述:你要做什么,输入输出是什么;
- 技术约束:用什么语言、UI框架、架构模式、SDK版本;
- 文件边界:这个类放哪一层,是ViewModel、Repository还是某个Composable组件;
- 交互方式:需要回调、状态流,还是直接返回值;
- 负面约束:哪些不要做,比如不要生成XML、不要用已废弃API、不要写死测试数据。
举个例子。如果你需要生成一个带分页加载的新闻列表页面,合格的说法是:
“我现在的项目是Kotlin + Jetpack Compose,MVVM架构,网络层用Retrofit2,已经定义好了数据类NewsItem(id, title, summary, coverUrl, publishTime)。请帮我写一个新闻列表页的Compose UI,要求:使用LazyColumn渲染,支持下拉刷新,支持到达底部加载更多,加载状态用stateFlow管理,UI需要覆盖loading、success、error三种状态。不要生成网络层代码,不要生成ViewModel,只生成UI部分,并结合companion object提供Preview。”
这个提示词里包含了足够多的“边界信息”,AI看到这些约束后,会主动往项目标准写法上靠拢,而不是输出一个自创的结构。
反过来,如果你只是说“做一个新闻列表”,AI大概率会用ViewModel+Navigation+网络请求全链路生成,而且生成结构跟你项目风格的匹配度非常低,改起来比重新写还痛苦。
再分享一个经验:遇到复杂的UI页面,别让AI一次性生成整个页面,而是拆成“组件级”任务。比如首页可以拆成顶部搜索栏、Banner轮播、分类标签、推荐商品列表四个Composable,分别生成再组合。这样每一块的代码量都在AI能稳定处理的范围内,组合错误也更容易定位。
2.2 数据层、UI层与状态管理的AI生成技巧
Android项目里最容易“被AI带偏”的就是状态管理。很多AI生成的ViewModel,看代码结构挺像回事,但仔细检查会发现根本不符合生命周期规范,比如直接把协程作用域挂在viewModelScope外面、在UI层直接收集外部Flow不做状态转换、遗漏StateFlow的初始化策略等。
这里有一个非常核心的原则:AI生成的代码,结构可以听它的,生命周期归属必须由你把关。
举个例子,我让AI写过一个登录页的ViewModel,它的初始版本在登录方法内部自己创建了一个CoroutineScope,还试图在onCleared里手动取消。这在功能上没大问题,但放在真实项目里就是埋雷——使用viewModelScope才是MVVM下最合理的生命周期绑定方案。我需要做的就是在提示词里强调“所有协程必须使用viewModelScope,不要在ViewModel里创建CoroutineScope”,AI下一轮就会输出符合规范的设计。
Compose项目的状态管理,我习惯让AI遵循“State hoisting(状态提升)”模式:Composable自身不持有可变状态,状态由上层ViewModel持有,通过State或StateFlow下发。这个模式也适合AI生成,因为AI在生成这类代码时通常能把握好“无状态组件 + 回调事件”的结构,代码看起来非常干净。
在一次实际项目中,我让AI生成了一个表单页,包含多个输入框和提交按钮。初版代码把每个TextField的Value和OnValueChange都写在Composable内部,保存按钮状态也能自洽,但一旦涉及跨页面共享数据,这个结构就完全扛不住了。后来我在提示词里明确了“所有输入状态都通过ViewModel的StateFlow暴露,界面只负责渲染和事件回调”,修改后不仅代码结构清晰了,后面做数据校验、草稿保存也变得非常轻松。
另外,AI在处理Compose预览(@Preview)时经常漏掉,或者生成一个需要传入大量参数才能运行的高耦合预览。我一般的做法是把它作为负面约束写进提示词:“组件需要提供独立的@Preview,必须支持无参数预览或使用默认参数。”这样生成的Composable会天然保持低耦合,对后期调试和团队协作都有好处。
2.3 一个核心认知:AI是结对程序员,不是代码生成器
这个点对我来说特别重要,甚至算得上整个项目里最深的一层认知。
把AI当成“代码生成器”,你会觉得它时灵时不灵;把它当成一个“坐在你旁边的结对程序员”,你才会主动给它上下文、和它讨论方案、对它给出的代码做评审。这个思维切换直接影响协作质量。
举个例子。如果只是问AI:“如何实现一个文件下载功能?”它通常会给出一段带有基本注释的示例代码。如果把它当成结对伙伴,你会说:“我正在做一个文件管理App,需要支持下载进度显示,用户可能随时取消下载。目前服务端的文件URL没有有效期限制,但文件可能很大。请帮我设计一个下载流程,要求考虑断点续传、网络切换处理、进度更新与通知栏联动。使用WorkManager和OkHttp实现。”
后者的问题包含了业务背景、关键约束、技术选型、异常场景四个维度的信息,AI给出的就不再是孤立代码,而是一个完整的技术方案。这种输出拿去落地,改动成本非常低。
所以我不建议任何人把AI工具当作“写代码的机器”,而是把它当作一个知识面很广、但缺乏项目上下文的新同事。你在下需求的时候花30秒把背景讲清楚,它回馈给你的就不只是一段代码,而是可以落地的设计思路。
3. 实操过程与核心环节实现
3.1 小项目实操:做一个GitHub仓库健康度监控工具
理论讲再多,不如直接跑一个小项目。我在这里用一个真实练手案例“GitHub仓库健康度监控”来展示完整的AI协作流程。
这个工具的需求很简单:输入一个GitHub仓库地址,展示仓库的基础信息、Star数量、最近Issue列表、提交频率,还能一键打开仓库页面。技术上需要用到GitHub的公开REST API,不涉及认证,非常适合验证AI辅助开发的完整链路。
项目划分成几个明确任务:
- 网络层:Retrofit2接口定义,返回结果统一封装;
- 数据层:Repository负责调用网络接口并转换为UI状态;
- UI层:Compose实现搜索页和详情页,支持加载状态;
- 状态管理:ViewModel持有页面状态,通过StateFlow下发。
我全程用AI辅助完成,下面记录一下实际操作过程中几个关键环节的处理方式。
3.2 分步实现:提示词、生成结果与应用调整
第一步是先让AI生成网络层。我给AI的提示词是:
“项目使用Kotlin 1.9 + Retrofit2 + OkHttp + kotlinx.serialization,Target SDK 34,最低支持API 26。请帮我定义一个GitHub API的Retrofit接口。需要以下方法:1. 根据仓库全名获取仓库信息;2. 获取仓库最新10个issue,state默认open;3. 获取仓库最近提交记录。返回的JSON结构如下:仓库信息包括full_name、description、stargazers_count、forks_count、open_issues_count、html_url;issue包括title、created_at、html_url、user.login;提交记录包括sha、commit.message、commit.author.date。接口返回类型请直接用对应的数据类,并为每个数据类标注@Serializable。最后用object RetrofitClient声明单例,baseUrl设为https://api.github.com/。不要添加多余注释。”
这段提示词的“含金量”在于给出了明确的JSON字段,AI据此生成的data class不需要我再改字段名,Retrofit接口的方法语义也和实际调用完全对上。
AI生成的代码基本符合要求,不过有两处需要微调:一是OkHttp的Header拦截器AI没加,需要手动补上“Accept: application/vnd.github+json”请求头;二是它把RetrofitClient里的GsonConverterFactory换成了kotlinx.serialization的Converter,这个改动是合理的,因为我提示词里本来就指定了kotlinx.serialization。
第二步是生成Repository层。我的提示词是:“写一个GitHubRepository类,依赖上面RetrofitService接口。提供三个挂起函数,分别返回仓库信息、issue列表、提交记录。要求对异常做统一处理,返回值统一使用Result封装,网络异常时需要把IOException和HttpException转换成带可读消息的错误类型。每个函数单独定义sealed interface的结果状态,包含Success、Error两种状态。”
这里建议你把“Result封装”具体化,否则AI默认会用Kotlin标准库的Result,使用起来有点别扭。
生成的代码结构很干净,接口状态用了sealed interface,错误类型也区分了超时、无网络、HTTP错误。我只需要改一下错误提示的文字,让提示语更适合中文环境。
第三步是UI层。我让AI生成搜索页,提示词是:“用Jetpack Compose写一个仓库搜索页面,顶部是输入框,输入过程中不回发请求,点击搜索按钮才查询。查询中显示CircularProgressIndicator,结果显示仓库名、Star数、描述,点击条目跳转详情页。页面用ViewModel持有状态,UI状态用sealed interface定义:Idle, Loading, Success(repo), Error(message)。搜索方法内部调用Repository并更新状态。请把页面拆分成SearchScreen和SearchScreenContent两个组件,SearchScreen负责连接ViewModel,SearchScreenContent负责纯渲染,必须提供无参数Preview。”
AI生成后,整个页面可以直接编译运行,但Preview依然因为用了MaterialTheme的自定义配色看起来不太协调,我在Preview里套了一层自定义主题后解决。
到这里,这个小项目的核心链路已经从无到有跑通了。整个过程的体感是:除了在接口header和页面主题上做了少量调整,其余代码几乎不需要修改。同样的工作如果用传统方式手写,至少需要一两个小时,AI辅助下半个小时内搞定,而且是包含调试的。
3.3 编译调试:AI生成代码的完整适配流程
AI生成的代码虽然能跑,但要真正合入项目,还有几个固定的适配步骤,我建议你把它们当成标准流程来走:
第一是依赖核对。AI有时候会默认引入一些你已经有的库,或者用了一个你项目里根本没引入的API。所以在合入AI代码前,先检查它用了哪些import,再和你的build.gradle.kts里的依赖项做对照。比如AI生成的下载功能如果引用OkHttp的下载文件接口,但你的项目用的是HttpURLConnection,就需要统一技术栈。
第二是权限声明。Android里权限是很容易被AI忽略的点。AI生成的代码只要涉及网络、存储、定位、相机,就一定回去查一遍AndroidManifest.xml,确认相关权限有没有声明。我遇到过多次AI生成的代码编译没报错,跑到装机的时候直接SecurityException的情况。
第三是API版本兼容。AI默认会用当前最新的API写法,不代表你的最低支持版本能跑。比如API 33之前的通知栏权限,和API 33之后是完全不同的两套逻辑。我的做法是在提示词里显式写上“最低SDK 26”,同时让AI“所有API调用需要考虑API 26到34的兼容性”,它就会自动用兼容写法。
第四是硬编码资源。AI生成UI代码时,经常把文案、颜色、尺寸直接写死在Compose里。这种做法在Demo里没问题,但正式项目的规范通常要求把资源抽离到strings.xml和dimens文件。我一般让AI生成完代码后,再单独用一个提示词要求“把硬编码字符串提取到资源文件”,这样可以省去手工重构的时间。
经过这几步适配,AI生成代码才算真正具备合入项目的资格。说实话,只要你习惯了这套流程,AI产出的代码质量是相当可用的,尤其在模块边界清晰的情况下,它的输出甚至比不少初级工程师写的还要规范。不过有一点要时刻记得:合入前做代码评审是铁律,尤其是涉及数据安全、权限、资金相关的逻辑,绝不能让AI代码无审查就上线。
4. 常见问题与排查技巧实录
4.1 AI“幻觉”与编造API
用AI写Android时遇到最多的一个坑,就是“幻觉”:AI会一本正经地给你编造一个看起来像官方库、但实际上不存在的API。这个在接入一些依赖时特别常见,比如它可能会用“androidx.foo.bar”开头的类名,让你编译失败,但你搜遍官方文档也找不到这个类。
我的排查方法很简单:拿到AI给的代码后,先看它的import语句。如果看到自己不熟悉的依赖包名,就第一时间去查这个包是不是真实存在。尤其是那些看起来像“androidx.*”的包名,非常有迷惑性。如果你没有把握,直接在提示词里要求“不要使用除网络层之外的任何第三方库,所有代码基于Android SDK和Compose框架完成”,能在源头上掐掉幻觉依赖。
还有一次比较典型的场景:AI准备用某一个云服务SDK,它给出的初始化代码里用了某个据说是该SDK新版本的接口。我按代码敲完,发现在最新SDK文档里根本找不到这个API。后来查看它提到的版本号,发现那个版本已经是很久以前的历史版本了。从那以后我就养成了一个习惯:AI生成代码时,涉及外部SDK的,要求它“在代码中标注使用的SDK版本号,并给出官方文档链接”,这些信息虽然有水份,但至少能帮我在文档里更快定位到正确API。
4.2 版本兼容、空安全与协程作用域问题
AI写Kotlin的一个突出优点是空安全通常处理得不错,但这不代表它可以完全替代人工审查。尤其是在解析服务端返回的JSON时,AI经常默认“所有服务器字段都存在”,如果不加保护,一旦真实接口某个字段缺失,null进入代码后可能引发连锁崩溃。
我的处理方式是要求AI“所有可空字段用可空类型标记,解析后做非空判断,空值走默认值或错误分支”。这个提示词能显著提升生成代码在真实数据环境下的稳健程度。
协程作用域问题也很常见。AI写ViewModel时,偶尔会把耗时的网络请求直接丢到一个新建的线程里,虽然能跑,但不符合viewModelScope的规范,一旦页面销毁,协程根本不会自动取消,很容易触发内存泄漏。前面讲过,解决办法就是给AI下强约束:协程一律用viewModelScope,IO操作自动走Dispatchers.IO,不要在ViewModel外层创建协程作用域。
CompileSdk和MinSdk之间的兼容性问题也值得多说一句。一次我用AI生成了一段读取外部存储图片的代码,它在API 29之后用了新的媒体库读取方式,这部分是没问题的。但有一段针对API 28分区的降级逻辑,AI漏掉了READ_EXTERNAL_STORAGE权限运行时申请,导致低版本真机上闪退。这种问题在AI生成代码里其实很难靠“多问模型几次”解决,最靠谱的还是你在真机或模拟器上跑一遍低版本系统做验证。
4.3 效率管理:如何让AI输出更稳定的代码
AI写Android能不能稳定输出“靠谱代码”,很大程度上取决于你有没有一套稳定的输入规范。下面这张表是我自己实践下来整理出的提示词要素,可以直接复制着用:
| 提示词要素 | 示例 |
|---|---|
| 项目背景 | 我是Kotlin + Jetpack Compose项目,MVVM架构 |
| 版本约束 | Target SDK 34,minSdk 26,Android Gradle Plugin 8.1 |
| 文件职责 | 这个类只负责UI渲染,业务逻辑放ViewModel |
| 接口数据 | 数据类字段分别为id、title、content、status |
| 状态管理 | 使用StateFlow,UI状态用sealed interface定义 |
| 代码风格 | 使用Material 3,注释用中文,简洁明了 |
| 负面约束 | 不要引入额外依赖,不要用已废弃API,不要写死测试数据 |
每次写提示词都对着这个表过一遍,刚开始会觉得麻烦,多写几次就会固化成习惯。一旦习惯了,AI返回的代码基本是“改改就能合”的状态,省去大量返工时间。
还有一个效率技巧是分轮协作。第一轮让AI出方案,不直接写代码;第二轮确认方案后再让它实现;第三轮做代码评审,让AI自己给自己提优化建议。这个过程就像真正的代码审查流程。我试过让AI写一个复杂表单页,首轮方案里它建议把数据校验放在ViewModel里做,我觉得放在domain层更合理,于是让它在第二版实现里调整设计。如果没有第一轮的方案讨论,我可能就要对着生成完的满屏代码手动重写校验逻辑,效率反而更低。
4.4 排查实录:一个真实适配过程
分享一个印象比较深的排查场景。
有次用AI生成下载功能,第一版代码用OkHttp下载文件到应用专属目录,编译通过、高版本模拟器跑起来也正常。结果换到一台Android 10真机上,下载几十兆文件后页面无响应,Logcat里看到主线程忙,点击事件没有任何反馈。
最初怀疑是下载过程堵塞主线程,于是我把AI代码里的下载模块重新过了一遍:发现它用的是enqueue异步回调,理论上没有在主线程跑网络请求,但它在回调里直接把下载进度数据用MutableState更新到Compose,这本身没问题。后来又试了几次,发现是它忘记处理网络切换时下载任务的中断逻辑,Wi-Fi断开后回调一直没触发,界面卡死。
排查过程本身不算复杂,但这件事给我的启发是:AI生成了流程正向逻辑后,反向异常场景往往覆盖不全。你需要自己掂量业务场景里哪些异常最致命,主动在提示词里要求AI“考虑网络切换、重复点击、任务取消这些边界条件”。如果你自己不提,AI大概率不会主动帮你把错误状态的UI完整设计出来,这是模型特性决定的。
最后分享一个小习惯
如果只让我推荐一个提高AI协作质量的小技巧,那一定是“把AI当成刚入职的实习生,而不是搜索引擎”。
我现在的做法是每天早上开工前,把当天的任务拆成几条结构化备注,发给AI,让它先帮我把涉及到的技术方案、潜在风险点列出来,然后再动手写代码。这个习惯坚持了几个月,最大的变化是我发现自己做代码评审的时间越来越短了,因为AI在方案阶段就可以排除掉大量不合理的设计。
用AI做Android编程这件事,说到底不是什么玄学。想清楚边界、写好上下文、定义好约束,它就能成为一个得力的开发搭子。如果你也在尝试用AI提升Android开发效率,不妨从复制我上面这组提示词开始,先跑通一个小功能,再慢慢调整成适合自己项目的协作节奏。
