PyTorch 模型量化：精度损失不该只用一个数字概括
一、量化不是把float32换成int8就完事了
模型量化被描述得很简单：把浮点参数从32位压缩到8位，推理速度翻倍，内存占用减四分之一。但实际操作中，量化后的精度损失从来不是一个固定数字。某些层量化后几乎无损，某些层量化后输出完全不可用。全局精度指标（比如"mAP下降2%"）掩盖了具体哪几个层出了问题、哪些数值范围受影响最大、哪些样本因为量化而输出错误。不做逐层分析就贸然部署量化模型，见证奇迹的时刻可能变成灾难——线上推理结果在某些用户场景下完全失真。
量化的本质是数值空间的映射。float32有4亿多个可表示值，int8只有256个。映射方式决定了哪些精度被保留、哪些被丢弃。简单线性映射对均匀分布的参数效果好，但ReLU后的激活值分布严重偏斜，线性映射会把大部分量化级别浪费在低值区域，高值区域精度严重不足。
二、量化链路：从浮点模型到部署模型的逐层精度审计
flowchart TD A[浮点模型] --> B[逐层激活值统计] B --> C[分布类型判断] C --> D[均匀分布：线性量化] C --> E[偏斜分布：非线性量化] D --> F[量化参数计算：scale与zero_point] E --> F F --> G[逐层精度评估] G --> H{某层精度损失超阈值} H -- 是 --> I[该层保留浮点：混合精度] H -- 否 --> J[全量化部署] I --> K[混合精度推理] J --> K量化有两个关键参数：scale（缩放因子）和zero_point（零点偏移）。scale决定float值到int值的映射比例，zero_point决定float的零值对应int的哪个位置。线性量化（对称量化）的zero_point固定为0或128，非线性量化（非对称量化）允许zero_point偏移以适应偏斜分布。
逐层精度审计是量化工程的核心步骤。每个层量化后，用校准数据集跑一遍前向传播，对比量化前后输出的逐张量误差。误差超过阈值的层标记为敏感层，保留float32精度，其余层用int8。这就是混合精度量化（Mixed Precision Quantization）的基本思路。
三、量化工具与逐层审计：从全局指标到细粒度分析
下面是量化参数计算和逐层精度审计的实现。代码注释解释了关键设计决策。
from dataclasses import dataclass from typing import Callable import numpy as np @dataclass class QuantConfig: """单层量化配置：不同层可能用不同策略""" layer_name: str symmetric: bool = True # 对称量化：zero_point=0 # 设计原因：对称量化硬件支持更好，但偏斜分布用非对称量化精度更高 num_bits: int = 8 per_channel: bool = False # 逐通道vs逐张量量化 # 设计原因：卷积层权重逐通道分布差异大， # 逐通道量化比逐张量量化精度更高 calibration_method: str = "minmax" # minmax|percentile|entropy # 设计原因：minmax简单但受极端值影响， # percentile去掉极端值更稳健，entropy最大化信息保留 @dataclass class LayerQuantResult: """逐层量化结果：记录精度损失而非只看全局""" layer_name: str scale: float zero_point: int float_output_norm: float # 浮点输出的范数 quant_output_norm: float # 量化输出的范数 relative_error: float # 相对误差 max_abs_error: float # 最大绝对误差 # 设计原因：relative_error看平均精度损失， # max_abs_error看极端误差，两者都要看 sensitive: bool = False # 是否标记为敏感层 def compute_quant_params(tensor: np.ndarray, config: QuantConfig) -> tuple[float, int]: """计算量化参数：scale和zero_point""" if config.calibration_method == "minmax": # 设计原因：minmax方法简单但极端值会让scale过大， # 导致大部分正常值被压缩到int8的低位区域 vmin, vmax = tensor.min(), tensor.max() elif config.calibration_method == "percentile": # percentile方法：去掉前后1%的极端值 vmin = np.percentile(tensor, 1) vmax = np.percentile(tensor, 99) elif config.calibration_method == "entropy": # entropy方法：寻找让量化后信息熵最大的映射范围 # 见证奇迹的时刻：entropy方法让偏斜分布层精度损失减半 vmin, vmax = _entropy_range(tensor) else: vmin, vmax = tensor.min(), tensor.max() if config.symmetric: # 对称量化：正负范围对称，zero_point=0（或128 for uint8） abs_max = max(abs(vmin), abs(vmax)) scale = abs_max / (2 ** (config.num_bits - 1) - 1) zero_point = 0 else: # 非对称量化：适应偏斜分布 scale = (vmax - vmin) / (2 ** config.num_bits - 1) zero_point = int(round(-vmin / scale)) return scale, zero_point def _entropy_range(tensor: np.ndarray) -> tuple[float, float]: """基于信息熵的范围搜索：让量化保留最多信息""" candidates = np.linspace(tensor.min(), tensor.max(), 50) best_entropy = -1 best_range = (tensor.min(), tensor.max()) for lo in candidates[:25]: for hi in candidates[25:]: mask = (tensor >= lo) & (tensor <= hi) if mask.sum() < len(tensor) * 0.95: continue clipped = tensor[mask] hist, _ = np.histogram(clipped, bins=256) prob = hist / hist.sum() entropy = -np.sum(prob * np.log2(prob + 1e-10)) if entropy > best_entropy: best_entropy = entropy best_range = (lo, hi) return best_range def audit_layer_precision( float_output: np.ndarray, quant_output: np.ndarray, error_threshold: float = 0.05, max_error_threshold: float = 0.15, ) -> LayerQuantResult: """逐层精度审计：relative和max两个维度判断敏感度""" float_norm = np.linalg.norm(float_output) quant_norm = np.linalg.norm(quant_output) diff_norm = np.linalg.norm(float_output - quant_output) relative_error = diff_norm / float_norm if float_norm > 0 else 0 max_abs_error = np.max(np.abs(float_output - quant_output)) # 设计原因：relative_error看整体趋势， # max_abs_error看是否有单点严重失真 sensitive = relative_error > error_threshold or max_abs_error > max_error_threshold return LayerQuantResult( layer_name="", scale=0, zero_point=0, float_output_norm=float_norm, quant_output_norm=quant_norm, relative_error=relative_error, max_abs_error=max_abs_error, sensitive=sensitive, )四、量化权衡：精度、速度和硬件支持的交叉约束
模型量化的工程权衡不在精度vs速度这一条线上，而是多条交叉约束。第一是精度损失分布不均匀：某些层（通常是第一层和最后一层）量化后误差远大于中间层，全局指标"mAP下降2%"掩盖了最后一层输出偏移导致所有分类阈值失效的问题。混合精度量化是解决方案，但混合精度推理需要硬件支持float和int交替计算，部分推理芯片不支持。
第二是校准方法选择：minmax计算简单但受极端值影响，percentile更稳健但需要额外统计步骤，entropy方法精度最好但计算成本最高。生产部署通常用percentile做快速校准，entropy方法用于敏感层的精细调整。
第三是逐通道vs逐张量：逐通道量化对卷积层效果好，但每通道有独立的scale和zero_point，推理时需要逐通道反量化，计算逻辑更复杂；逐张量量化所有通道共享参数，推理更简单但精度更差。硬件支持也是决定因素：部分NPU只支持逐张量量化。
部署后还需要持续监控。量化模型的精度损失不是静态的，输入数据分布变化后原本合理的scale和zero_point可能不再适用。线上推理应记录输出异常率，定期用新数据重新校准。
五、总结
模型量化的精度损失不应只用全局数字概括，必须逐层审计relative_error和max_abs_error。敏感层保留浮点精度形成混合精度量化，校准方法按精度需求和计算成本选择minmax、percentile或entropy，卷积层建议逐通道量化。部署后需监控输入分布变化导致的量化参数失效，定期重新校准。
