条件编译与平台文件并存时如何控制小程序和React Native端的行为差异

# 核心结论

多端工程的目标不是强迫小程序与 React Native 执行完全相同的实现，而是保持领域规则、数据协议和错误语义一致，同时把宿主能力、生命周期、样式和构建差异限制在适配层。条件编译适合处理少量、稳定且能够在构建期确定的差异；平台专属文件适合替换一整块实现；运行时能力检测适合同一产物中因基础能力或设备环境不同而产生的差异。如果业务页面遍布平台判断，通常说明抽象边界已经失效。

# 底层机制

条件编译在构建阶段选择代码片段，被排除的分支通常不会进入目标产物，因此适合隔离平台专属依赖、配置和入口。但这也意味着项目实际存在多条代码路径，每条路径都必须独立构建和测试。构建环境变量可用于区分目标平台、构建模式和公