全整型量化需确保模型算子支持、提供固定shape校准数据并验证scale/zero_point；必须用SavedModel加载、启用resource_variables、设置INT8算子集及输入输出类型，且预处理须与训练完全一致。
量化前必须确认模型是否支持全整型推理
TensorFlow Lite 的量化不是“一键压缩”，它依赖模型算子是否在目标设备（尤其是边缘端）有对应的整型内核。如果你直接对一个含 BatchNorm、Softmax 或动态 shape 的模型做全整型量化，converter.convert() 会静默退化为浮点模型，或报 RuntimeError: Quantization not supported for op XXX。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
tf.lite.TFLiteConverter.from_saved_model()加载 SavedModel（不是 Keras.h5），确保图已冻结 - 启用
converter.experimental_enable_resource_variables = True，避免变量未解析导致量化失败 - 先尝试
converter.optimizations = [tf.lite.Optimize.DEFAULT]（仅权重量化），验证基础流程是否通 - 全整型量化必须提供校准数据集——哪怕只用 10 张图，且输入 shape 必须固定（不能有
None）
如何正确设置全整型量化（Integer-only quantization）
所谓“全整型”是指输入、输出、权重、激活全部为 int8，这是部署到微控制器或 TPU Edge 的常见要求。关键不在加参数，而在闭环验证。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 设置
converter.target_spec.supported_ops = [tf.lite.OpsSet.TFLITE_BUILTINS_INT8]，禁用浮点 fallback - 必须指定
converter.inference_input_type = tf.int8和converter.inference_output_type = tf.int8 - 校准函数必须返回
np.array，shape 与模型输入完全一致（如(1, 224, 224, 3)），dtype 推荐np.float32（converter 内部自动缩放） - 校准数据不能全黑/全白/空值——否则
min/max统计失效，量化后输出全零
示例校准函数片段：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
def representative_dataset():
for _ in range(10):
# 假设输入是归一化到 [0,1] 的 float32 图像
img = np.random.rand(1, 224, 224, 3).astype(np.float32)
yield [img]
converter.representative_dataset = representative_dataset
量化后模型输出异常？先查 input/output 的 scale/zero_point
量化模型的输入/输出不再是原始浮点语义，而是带 scale 和 zero_point 的 int8 张量。如果 Python 端直接把 float32 图喂进去，或把 int8 输出当 float 用，结果必然错乱。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
interpreter.get_input_details()[0]['quantization']查看输入的(scale, zero_point)，再手动将 float32 输入映射为 int8：int8_input = (float32_input / scale + zero_point).round().astype(np.int8) - 同理，输出需反向还原：
float32_output = (int8_output.astype(np.float32) - zero_point) * scale - 别依赖
interpreter.set_tensor()自动转换——它只认 dtype，不处理量化参数 - 用
netron.app打开 .tflite 文件，直接查看每个 tensor 的 quantization 参数，比代码 debug 更快
为什么量化后精度掉得厉害？重点检查预处理一致性
量化本身不引入显著误差，但训练时的预处理（如 ImageNet 的 mean/std 归一化）和量化校准时的预处理不一致，会导致输入分布偏移，从而放大量化误差。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 校准数据必须走和训练时**完全相同的预处理 pipeline**：包括 resize 方式（bilinear vs. nearest）、归一化顺序（先除 255 再减 mean，还是反过来）、通道顺序（RGB/BGR）
- 如果训练用的是
tf.keras.applications.preprocess_input()，校准也必须调用同一函数，不能手写公式 - 对分类模型，可临时用训练集的 validation subset 做校准（100–500 张足够），比随机生成更可靠
- 若仍掉点严重，尝试
converter.experimental_new_quantizer = True（TF 2.7+），新版量化器对非线性激活更鲁棒
量化不是黑盒压缩，它把模型从“浮点数学”切换到“定点工程”。scale 和 zero_point 不匹配、预处理漂移、算子不支持——这三个点卡住 90% 的实际问题。
