可组合函数是带有 @Composable 注解的 Kotlin 函数，它是 Compose 构建 UI 的Zui小单元。

说实话，这玩意儿kan起来挺普通的，但背后可是藏着大量编译器魔法的。

@Composable fun TextMessage { Text }

当你给函数加上 @Composable 注解，Kotlin Compose 编译器插件会Zuo三件事，哈哈，咱就是说这三件事挺关键的。

添加额外的参数，不对不对，应该是① 添加额外的参数。

编译器会为每个 Composable 函数隐式添加 Composer 和 Applier 参数，你懂的，这玩意儿挺有用的。

// 你的代码 @Composable fun TextMessage { Text } // 编译器转换后的等效代码 fun TextMessage { // ... 开始组合作用域 $composer.startRestartGroup // ... 状态追踪 $composer.track // ... 调用子 Composable Text // ... 结束作用域 $composer.endRestartGroup }

② 插入重组代码，害，这个也hen重要。

每次状态变化时Compose 运行时通过 Composer 对象跟踪哪些 Composable 函数读取了哪些状态，当状态改变时只重新执行对应的函数，说白了就是为了提高效率嘛。

③ 生成位置信息，这个那个那个，也是为了优化性Neng。

编译器为每个组合单元分配 groupKey 和位置信息，用于 Compose 在重组时准确定位和复用，你kan，这多牛逼。

@Composable fun Outer { Inner // ✅ OK，在 Composable 上下文中 } @Composable fun Inner { Text } fun NonComposable { // Text ❌ 编译错误！ // 不Neng在非 Composable 函数中调用 Composable 函数 }

@Composable 是传染性的——被它标记的函数只Neng在同一上下文中被调用，这意味着你的 UI 代码天然地被限制在正确的组合作用域内，不会乱套，哈哈。

Composable 函数可Neng因重组被频繁调用，因此它必须幂等——相同的输入产生相同的输出，不然就乱了你懂的。

// ❌ 违反：依赖函数调用顺序 var globalFlag = false @Composable fun A { if Text // 外部条件不可控 } @Composable fun B { globalFlag = true Text }

Composable 函数的执行顺序不应影响结果，否则重组时会出现难以追踪的 bug，说实话，这挺烦人的。

为什么百度不收录我的文章？

这个问题嘛，hen多人dou问过其实原因挺复杂的，有时候是内容质量的问题，有时候是搜索引擎算法的问题，你得具体问题具体分析。

如何提高百度收录率？

内容要原创且高质量 别总抄别人的东西，要有自己的见解和观点。

关键词合理使用 不要堆砌关键词，该用的时候用。

提升用户体验 让读者喜欢你的文章，他们才会愿意分享和转发。

好啦，现在回到我们的正题——Compose 的可组合函数命名规范与Zui佳实践上来吧！

名词大写开头 UserProfileMessageListLoadingIndicator

动词短语加 by 后缀 Button 而不是 DisplayButton

有语义，无歧义 宁长勿短，总之要让人kan得懂。

// 惯例 ：modifier 作为第一个可选参数 
@Composable 
fun UserAvatar( 
   url: String, 
   modifier: Modifier = Modifier,  // 第一个可选参数 
   size: Int = , 
   onClick:  -> Unit)? = null 
) 
// 惯例 ：内容 lambda 作为Zui后一个参数 
@Composable 
fun Card( 
   modifier: Modifier = Modifier, 
   content: @Composable  -> Unit  // Zui后一个参数 
)

这是遵循 Material Design 组件的设计惯例，让组件调用方式统一，kan起来舒服多了。

// ❌ 一个 Composable 包含太多逻辑 
@Composable 
fun ComplexScreen { 
   var text by remember { mutableStateOf } 
   var items by remember { mutableStateOf) } 
   var isLoading by remember { mutableStateOf } 
   Column { 
       // 搜索栏 
       TextField 
       // 列表 
       if  CircularProgressIndicator 
       else LazyColumn { items { ... } } 
       // 底部按钮       
       Button { Text }    
   }    
} 
// ✅ 拆分为多个小函数    
@Composable    
fun SearchScreen {    
   var query by remember { mutableStateOf }    
   var state by remember { mutableStateOf<UiState> }    
   Column {        
       SearchBar        
       when  {            
           is Loading -> LoadingIndicator            
           is Success -> ResultList            
           is Error -> ErrorView        
       }        
       SubmitButton    
   }    
}

原则 一个 Composable 只Zuo一件事，既是代码组织的良好实践，也是重组优化的关键——geng小的函数意味着geng精确的重组范围。

// 将 Composable 作为参数传递   
@Composable   
fun ScreenLayout(   
   header: @Composable  -> Unit,   
   content: @Composable  -> Unit,   
   footer: @Composable  -> Unit = {}   
) {   
   Column {       
       Box) { header }       
       Box) { content }       
       footer   
   }   
} 
// 使用时  
ScreenLayout(   
   header = { TopAppBar }) },   
   content = { Greeting },   
   footer = { BottomNavigationBar }   
)

这种函数式的组合方式，使 UI 复用达到前所未有的灵活度——不需要继承、不需要接口回调，你kan，多简洁！

下一篇：布局系统总览——从 Row、Column 到 Box 的声明式布局思维。