本文面向 HarmonyOS 7 应用开发。涉及系统能力时，以项目实际安装 SDK 的 API、权限及设备支持为准；下文代码注明为局部示例，不构成完整可运行工程。

把质量改成50，文件为什么还是很大

上传发票时，开发者常把编码质量从100调到50，然后等待体积减半。实际结果未必如此。照片尺寸、纹理、噪点、编码格式都会影响输出。质量参数不是文件大小的线性旋钮，更不能直接理解成“保留百分之多少清晰度”。

在鸿蒙中，图片解码、像素处理和重新编码可以由 Image Kit 承担。业务首先要决定的是目标：聊天图片注重快速传输，票据图片注重文字可辨认，透明图还要保留透明效果。三类内容不该使用同一套硬编码参数。

先缩尺寸，再调质量

假设产品要求长边不超过1600像素，这是本例业务策略。原图4000×3000，按比例缩成1600×1200，再进行编码，比只调整质量更可控。不要为了得到小文件，直接拉伸成固定的1600×1600。

interface ImageSize { width: number; height: number; }
function fitSize(width: number, height: number, maxEdge: number): ImageSize {
  if (width <= 0 || height <= 0 || maxEdge <= 0) {
    throw new Error('图片尺寸无效');
  }
  const scale = Math.min(1, maxEdge / Math.max(width, height));
  return { width: Math.max(1, Math.round(width * scale)),
    height: Math.max(1, Math.round(height * scale)) };
}

这个函数只计算尺寸。读取方向信息、解码、缩放、编码以及资源释放，需要由实际图片处理层完成。

设置一个有终点的压缩过程

如果服务器要求不超过某个字节数，可以先按基准尺寸和质量编码，再检查实际体积。如果仍超限，降低质量或适度缩小尺寸。但必须设置最小可接受清晰度和最大尝试次数，否则一张难压缩的照片会让用户一直等待。

完成判断不只检查字节数，还要重新读取输出文件，确认格式、宽高和可解码性。票据场景最好使用真实小字、印章和浅色底纹样本人工评估；只拿风景图测试，容易漏掉文字模糊。

注意透明与方向

透明头像如果转换为不保留透明通道的格式，需要明确背景颜色。照片带有方向元信息时，预览和最终编码应得到一致的视觉方向。否则用户看到的是竖图，上传以后可能变成横图。

另外，大图解码后的内存开销可能远大于源文件。不要同时保留原始位图、预览位图和多份编码中间结果。处理结束后释放图片对象，临时输出也要与业务任务绑定。

验收用同一组照片记录原始体积、输出体积、像素尺寸、耗时和文字可读性，再选择参数。这比一句“统一压到质量60”更有依据，也更容易解释为什么某类图片需要不同策略。

官方参考

• 华为开发者文档
• HarmonyOS 7 新能力与开发入口

本文的业务拆分、参数策略与验收场景为原创实践建议；系统能力说明参考以上文档。资料核对日期：2026-10-16。