避坑指南 · ONNX 转换
🧩 30 章完整版
PyTorch → ONNX
01
ONNX 基础认知
什么是ONNX
为什么需要ONNX
生态与工具链
02
PyTorch 导出核心API
torch.onnx.export
动态轴/静态轴
参数详解
03
导出前准备工作
eval模式
输入格式
设备一致性
04
算子支持与坑
算子映射
不支持替代方案
05
动态形状处理
dynamic_axes
翻车原因
正确设置
06
控制流与动态图
if/for陷阱
torch.jit.script
07
自定义算子导出
注册自定义算子
ONNX Runtime加载
08
输入输出命名与调试
起名技巧
onnxruntime调试
09
模型验证与精度对比
onnxruntime验证
精度阈值
损失原因
10
量化模型导出
QDQ格式
INT8导出
注意事项
11
多输入多输出模型
多输入技巧
多输出命名
12
Batch维度处理
固定/可变Batch
ONNX表示
13
ONNX模型可视化
Netron
发现潜在问题
14
模型简化与优化
onnx-simplifier
常量折叠
节点融合
15
模型分块与合并
分块导出
合并方法
16
ONNX Runtime部署
C++/Python接口
性能调优
17
TensorRT 部署
TensorRT支持
动态形状处理
18
OpenVINO 部署
ONNX支持
转换与推理优化
19
移动端部署
NCNN/MNN
端侧优化
20
模型加密与保护
加密方案
自定义解密加载
21
版本兼容性
opset差异
选择合适版本
22
调试工具链
调试模式
onnxshapeinference
23
常见错误与解决方案
错误码解析
运行时排查
24
性能分析
profiling工具
瓶颈分析
25
TensorFlow互转
onnx-tf
转换注意事项
26
CoreML 互转
onnx-coreml
iOS部署适配
27
云端部署
Triton Server
多模型管理
28
边缘设备部署
Jetson系列
资源受限优化
29
测试与CI/CD集成
自动化测试
质量门禁
30
实战项目总结
全流程案例
常见问题复盘