跨平台开发是编程语言领域最卷的方向之一，仓颉给出的答案不太一样——它不是解释器跨平台（像React Native），也不是虚拟机跨平台（像Flutter），而是静态编译跨平台。一份代码用仓颉编译器分别编译成鸿蒙、Android、iOS、Windows、Linux、MacOS的本地机器码。白皮书把这种方案叫做"同构开发、异构运行"，开发者需要理解的是一套代码，各平台得到的是各自的原生应用。

仓颉的跨平台方案与主流跨平台框架有本质区别。React Native和Flutter采用解释器或虚拟机执行方式，在不同平台上运行同一份中间代码。仓颉走的是静态编译路径：一份仓颉源码分别编译为各平台的本地机器码，在鸿蒙上编译为鸿蒙的机器码，在Android上编译为Android的机器码，在iOS上编译为iOS的机器码。

白皮书将这一能力概括为"同构开发、异构运行"。开发阶段编写的是同一套仓颉代码，运行阶段各平台执行的是各自的原生机器码。这意味着仓颉应用在各平台上都能获得接近原生语言的性能表现，没有解释器或虚拟机的运行时开销。

仓颉编译器面向主流平台提供编译与交叉编译能力，当前覆盖鸿蒙、Android、iOS、MacOS、Windows、Linux六大目标场景。跨平台能力已被列为仓颉语言的核心定位之一——白皮书在仓颉概述中将其与高性能、强安全、智能化并列。

跨平台不仅是编译层面的能力，更体现在工具链层面：仓颉提供了统一的多端调试工具cjd，基于lldb演进而来，以统一方式支撑多平台程序的源码级调试。功能覆盖断点、代码执行控制、信息查看、内存操作等调试场景，并在单步和协程调试上进行了体验改进。

仓颉支持通过编译标记@When[...]对导入和声明进行条件编译。内置条件变量包括os、arch、env、backend等，开发者可以在同一份源码中用代码显式区分平台差异。

条件编译宏适用于函数级的平台差异处理——当某个函数在鸿蒙和Android上的实现仅差几行代码时，使用@When比创建两个文件更简洁。

对于更大的平台差异，仓颉提供了common和specific两类声明来组织跨平台代码。common定义共享声明及公共实现，承载平台无关的业务逻辑、领域模型和抽象接口；specific定义面向具体平台的实现，承载系统API、设备能力和平台框架接入。

白皮书用完整的跨平台日志库案例展示了common/specific的使用方式。log.cj中定义common接口：

```cangjie

public common func log(tag:String, msg: String): Unit

public common func logE(tag:String, msg: String): Unit

```

android/platform_utils.cj中实现Android平台具体逻辑，调用_android_log_print。ios/platform_utils.cj中实现iOS平台具体逻辑，调用FfiLog。业务代码只依赖common接口，编译器根据目标平台自动选择对应的specific实现。调用方完全不需要感知当前运行平台，平台无关的设计原则被严格执行。

工具库类（如日志、网络、数据库、文件操作）是仓颉跨平台能力的最佳适用场景。不同平台有各自的系统API，但调用方的使用方式可以完全统一。开发者只需在common层定义一套公共接口，在各平台的specific目录下实现底层调用，上层业务代码完全平台无关。

白皮书中的日志库案例正是这一场景的典型代表。跨平台工具库的构建可以让应用核心逻辑的代码复用率达到最高，各平台仅需编写平台特定的适配层代码，大幅降低多端维护的人力成本。

白皮书以某电商应用为例展示了跨平台能力的商业价值。该电商采用自研开发框架，需同时维护iOS、Android、鸿蒙三个端的后端业务逻辑，各端独立开发分别迭代，同一业务逻辑存在多份实现。

使用仓颉跨平台能力的核心价值体现在两个层面：代码共享——通过common/specific机制共享业务逻辑代码，三端统一维护一套代码库；性能原生——仓颉直接编译为目标平台原生代码，三端均获得接近原生的运行性能，避免了跨平台框架常见的性能损耗。

仓颉未来将在以下方面持续优化跨平台调优能力：跨语言对象引用关系记录——在仓颉内存快照中支持记录Java/Objective-C与仓颉互相引用的能力；跨语言混合栈——支持仓颉和Java/Objective-C互操作，在应用崩溃、采样、内存调优等场景下显示混合栈；支持Java/Objective-C与仓颉互相调用时的混合调试。

仓颉的跨平台生态复用策略包括：跨平台UI库的接入、跨平台系统库的复用、以及与Java/Objective-C的互操作。在跨平台开发中，UI层通常复用现有的跨平台UI框架（如Flutter、React Native的鸿蒙适配版本），业务逻辑层和数据层使用仓颉实现，通过互操作机制打通各层。

仓颉的跨平台能力不是"写一份代码跑所有平台"的黑盒方案，而是提供了一套精细的平台差异管理工具。最佳实践包括：common层承载尽可能多的平台无关逻辑，specific层只封装必要的平台特定实现；条件编译宏用于轻量级平台差异，common/specific用于重量级平台差异；调用方永远只依赖common接口，不依赖specific实现细节。