企业级 Jetpack Compose 项目入门版最佳结构适合人群Compose 初学者Android 中大型业务后续可扩展模块化团队协作MVVMClean Architecture轻量版不分 module先单 module一、推荐技术栈2026 企业标准分类技术说明核心Kotlin官方UIJetpack ComposeUI 框架UI 规范Material3UI 规范页面跳转Navigation Compose页面跳转状态管理ViewModel状态管理UI 状态StateFlowUI 状态异步Coroutines异步网络Retrofit网络请求网络拦截OkHttp网络拦截JSONKotlin Serialization / GsonJSON 解析本地数据库Room本地数据库DI 注入HiltDI 注入图片加载Coil图片加载二、真正适合企业的目录结构不分 module但已经是企业规范。app/ ├── api/ # 网络层 │ ├── ApiService.kt │ ├── ApiClient.kt │ └── interceptor/ │ ├── base/ # 基类 │ ├── BaseViewModel.kt │ ├── BaseActivity.kt │ ├── BaseRepository.kt │ └── UiState.kt │ ├── common/ # 通用 │ ├── constants/ │ ├── ext/ │ ├── utils/ │ └── manager/ │ ├── data/ # 数据层 │ ├── model/ │ ├── dto/ │ ├── entity/ │ ├── repository/ │ └── local/ │ ├── ui/ │ ├── theme/ │ ├── components/ │ ├── navigation/ │ └── pages/ │ ├── home/ │ ├── login/ │ ├── profile/ │ └── ... │ ├── viewmodel/ │ ├── di/ # Hilt 依赖注入 │ ├── route/ # 路由常量 │ ├── App.kt └── MainActivity.kt三、为什么这样设计这是企业项目的渐进式架构不是feature-home feature-login feature-user这种上来就模块化。因为新人最容易死在module 依赖component 依赖Hilt 跨 modulenavigation 共享多 module 调试导致Compose 还没学会架构先崩了。所以企业正确成长路线第一阶段你现在单 module但是分层、规范、MVVM、状态管理、UI 规范、Repository、网络层全部完整。第二阶段再拆feature-home feature-login core-network core-ui core-common这才是真正企业路线。四、Compose 企业规范核心1. 页面结构Page ViewModel例如HomePage.ktHomeViewModel.kt不要HomeScreen.ktHomeScreen2.ktHomeContent.kt新人很容易乱。2. UI 状态统一管理不要varloadingbymutableStateOf(false)varlistbymutableStateOf(...)varerrorbymutableStateOf(...)企业规范dataclassHomeUiState(valloading:Booleanfalse,vallist:ListArticleemptyList(),valerror:String)ViewModelprivateval_uiStateMutableStateFlow(HomeUiState())valuiState_uiState.asStateFlow()ComposevaluiStatebyviewModel.uiState.collectAsState()3. 不要把网络写进 ViewModel错误viewModelScope.launch{retrofit.getList()}正确ViewModel ↓ Repository ↓ Api五、企业级 Compose 页面结构推荐home/ ├── HomePage.kt ├── HomeViewModel.kt ├── HomeUiState.kt ├── HomeAction.kt ├── components/ │ ├── Banner.kt │ ├── ArticleItem.kt │ └── ...为什么企业项目页面越来越大。如果HomePage.kt写 3000 行后期必炸。六、企业级 Navigation 规范route 统一管理objectRoute{constvalHOMEhomeconstvalLOGINloginconstvalPROFILEprofile}NavigationHostNavHost(navControllernavController,startDestinationRoute.HOME){composable(Route.HOME){HomePage()}composable(Route.LOGIN){LoginPage()}}七、企业级 Compose UI 规范1. 组件化不要Column{...}写几千行。应该HomeHeader()BannerSection()ArticleList()2. 组件命名规范类型命名示例页面HomePage、LoginPage、ProfilePage组件UserCard、ArticleItem、HomeBannerDialogDeleteDialog、LogoutDialog八、企业级状态管理重点页面只做状态消费when{uiState.loading-{...}uiState.error.isNotEmpty()-{...}else-{...}}不要页面自己请求网络、写业务、处理数据。九、企业级主题规范theme/ ├── Color.kt ├── Theme.kt ├── Type.kt └── Dimens.kt不要魔法值❌padding(13.dp)✅padding(AppDimens.Space16)十、真正企业级开发流程一个新页面如何开发定义 UI 状态data class UserUiState()写 Repositoryclass UserRepository写 ViewModelclass UserViewModel写 Compose 页面UserPage()拆组件UserHeader、UserInfo、UserList接 Navigation十一、新人最容易踩的坑1. Compose 写成 XML 思维❌ 一个页面几千行2. 所有状态都用 mutableStateOf企业里大部分StateFlow UiState3. 页面直接请求网络❌ 禁止4. Navigation 乱跳❌ 必须 route 统一、参数统一、页面唯一入口5. Composable 乱传 ViewModel❌ArticleItem(viewModel)✅ArticleItem(article xxx, onClick {})组件无状态化 —— 这是企业核心。十二、推荐学习路线第一阶段先掌握Compose 基础StateStateFlowNavigationViewModel第二阶段再学HiltRepositoryRoomRetrofit第三阶段再学MVI多 moduleCompose 性能优化Design System动态化十三、真正适合你的项目模板推荐练手项目资讯类 APP因为包含BannerTab列表登录收藏搜索网络分页状态管理几乎企业全覆盖。十四、最终推荐如果你是Compose 入门 → 企业路线那么最佳方案单 module 企业规范目录不要一开始Clean Architecture 究极版MVI 究极版多 module插件化否则80% 新人直接崩。真正企业成长路线Compose 基础 ↓ 规范 MVVM ↓ Repository ↓ 状态管理 ↓ 组件化 ↓ 模块化 ↓ 大型架构这才是正确路线。十五、Flow ViewModel 企业标准组合是的。现在企业里Flow ViewModel 是标准组合。不是 “有了 Flow 就不用 ViewModel”而是ViewModel 负责管理 Flow。1. 三者关系角色ViewModelFlowCompose定位生命周期 状态管理层数据流UI 层负责持有 UI 状态、页面数据管理、页面销毁不丢数据、协程作用域、调用 Repository数据变化通知、响应式更新、异步流、状态分发显示状态、响应用户操作所以真正企业结构Compose UI ↑ collectState ViewModel ↑ StateFlow Repository ↑ Flow DataSource / API2. 企业里真正的标准写法ViewModelHiltViewModelclassHomeViewModelInjectconstructor(privatevalrepository:HomeRepository):ViewModel(){privateval_uiStateMutableStateFlow(HomeUiState())valuiState_uiState.asStateFlow()init{loadData()}privatefunloadData(){viewModelScope.launch{repository.getArticleList().collect{list-_uiState.update{it.copy(articleListlist)}}}}}RepositoryclassHomeRepositoryInjectconstructor(privatevalapi:ApiService){fungetArticleList():FlowListArticleflow{emit(api.getArticleList())}}ComposeComposablefunHomePage(viewModel:HomeViewModelhiltViewModel()){valuiStatebyviewModel.uiState.collectAsState()LazyColumn{items(uiState.articleList){article-// ...}}}3. 为什么现在大量推荐 Flow能力FlowKotlin 官方✅协程支持✅链式操作✅combine✅debounce✅retry✅异常处理✅Room 支持✅Compose 支持✅4. ViewModel 为什么没淘汰因为 Flow 不负责生命周期页面状态保存configuration changeviewModelScope页面逻辑管理举个例子屏幕旋转时如果没有 ViewModel页面重建数据重新请求用户体验很差。而 ViewModel 可以保留状态。5. 现在企业最主流的组合层级技术UI 层Compose状态层ViewModel响应式层StateFlow数据层Repository6. StateFlow 和 SharedFlow 区别StateFlow— 用于 UI 状态有初始值保存最新状态例如val uiState: StateFlowHomeUiStateSharedFlow— 用于一次性事件无初始值例如Toast、跳转、Dialog、支付结果例如private val _event MutableSharedFlowHomeEvent()7. 企业现在已经很少用❌ LiveData / MutableLiveData❌ XML❌ Fragment XML8. Compose 企业推荐架构2026Compose ViewModel StateFlow Repository Hilt这是现在最稳的。9. 很多人误区误区 1❌ “Compose 不需要 ViewModel”✅ 真正企业Compose 更需要 ViewModel。因为 Compose 重组频繁更需要状态管理和生命周期管理。误区 2❌ “mutableStateOf 就够了”小 Demo 可以。企业不行。企业要求页面状态统一为data class UiState()然后用MutableStateFlow(UiState())。10. 最终企业推荐场景推荐方案小状态输入框、checkbox、tabremember { mutableStateOf() }页面状态列表、网络、登录、用户信息、分页、搜索ViewModel StateFlow11. 你现在最应该学的组合推荐顺序第一阶段Compose、ViewModel、StateFlow、Navigation第二阶段Repository、Retrofit、Hilt、Room第三阶段MVI、多 Module、性能优化、Design System12. 真正企业里的标准模板现在很多大厂实际就是Compose UI ↓ ViewModel ↓ MutableStateFlow ↓ Repository ↓ Retrofit / Room这是目前 Android 最主流方案。
