169、NPU的编译器开发：模型版本兼容性

NPU的编译器开发：模型版本兼容性

去年冬天，我在调试一款边缘NPU芯片的推理管线时，遇到了一个让人头皮发麻的问题。客户反馈说，同一个模型文件，在开发板上跑得好好的，到了量产板上就输出全零。我花了整整三天，从硬件寄存器一路追到编译器后端，最后发现罪魁祸首是模型文件里一个不起眼的版本号字段——编译器在解析时，默认跳过了“未来版本”的兼容处理。

这种问题在NPU编译器开发中太常见了。模型版本兼容性，听起来像个文档规范问题，实际上它直接决定了你的芯片能不能跑别人家的模型、能不能跑自己家旧版本的模型。今天我们就从编译器实现的角度，把这个坑彻底填平。

版本号不是装饰品

很多刚入行的同学觉得模型文件里的版本号就是个标识，随便写写就行。大错特错。NPU编译器在解析模型时，版本号决定了它如何解释二进制流中的每一个字节。

举个例子，我们团队早期定义过一种模型格式，版本1的权重排布是[N, C, H, W]，版本2改成了[N, H, W, C]。如果编译器不检查版本号，直接用版本2的解析逻辑去读版本1的模型，出来的权重全是乱的。更可怕的是，这种错误不会报错——它只是算出一个错误的结果，你很难定位。

所以，编译器在解析模型的第一步，必须做版本校验。我习惯的做法是：先读版本号，然后根据版本号选择对应的解析器。不要试图用一个解析器兼容所有版本，那会让代码变成一团乱麻。

// 这里踩过坑：早期用switch-case处理版本，后来版本多了发现维护成本太高