如何在Node.js中使用Sharp将图片调整为完美正方形尺寸？

不需要强制设置写死的相等宽高参数才能生成符合要求的正方形图片，硬传固定相等宽高反而容易导致图片拉伸变形、分辨率下降，尤其不适合电商场景商品图的处理需求。

硬写固定相等宽高的缺陷 #

直接调用resize(800, 800)这类传入固定相等宽高的写法，虽然输出尺寸是正方形，但存在明显问题：

• 原图比例非1:1时，图片会被强制拉伸变形，直接影响商品展示效果
• 原图分辨率低于设定值时，强制放大后会出现模糊、锯齿问题
• 无法适配不同构图的原图，容易把商品主体裁出画面

无变形生成正方形图片的正确实现 #

Sharp 本身内置了多种适配策略，不需要手动计算宽高，就能生成无变形的正方形图，适配不同电商场景需求：

1. 裁剪式正方形（最常用商品主图方案） #

等比缩放后裁剪多余区域，全程无拉伸，可控制裁剪重心保留商品主体：

const sharp = require('sharp');

// 输出800*800无变形正方形主图
sharp('original-product.jpg')
  .resize({
    width: 800,
    height: 800,
    fit: 'cover', // 等比缩放至完全覆盖正方形区域
    position: 'centre' // 裁剪时优先保留画面中心区域，可按需调整为top、bottom等位置
  })
  .toFile('square-main.jpg')

2. 留白式正方形（适配不允许裁切商品的平台规则） #

等比缩放后在空白区域填充指定背景色，商品完整展示不裁切：

sharp('original-product.jpg')
  .resize({
    width: 800,
    height: 800,
    fit: 'contain',
    background: { r: 255, g: 255, b: 255, alpha: 1 } // 空白区域填充纯白色，可按需改色
  })
  .toFile('square-padding.jpg')

3. 自适应正方形（无需预设固定尺寸） #

不需要提前写死宽高数值，自动按原图短边长度裁剪，生成无缩放损失的正方形图：

sharp('original-product.jpg')
  .resize((metadata) => {
    const squareSize = Math.min(metadata.width, metadata.height);
    return {
      width: squareSize,
      height: squareSize,
      fit: 'cover',
      position: 'centre'
    }
  })
  .toFile('square-auto.jpg')

• 所有正方形输出的核心要求是最终输出宽高数值相等，但这个数值不需要开发者手动写死固定值，结合Sharp的适配策略、原图元数据可以自动计算，适配性远高于硬编码固定宽高的写法。

内容的提问来源于stack exchange，提问作者Developedbynick