如何解决圆形UIImageView显示横图时的上下空白问题？

这个问题我之前也碰到过，其实核心原因主要有两个：你的UIImageView可能不是严格的正方形，或者图片的显示模式没配置到位，导致横向图片没法填满圆形区域。下面给你一步步的解决方案：

1. 确保UIImageView是正方形 #

这是实现正圆的基础，如果你的ImageView宽高不相等，那用height/2作为圆角半径，只会生成一个椭圆（或半椭圆），自然会出现留白。

• AutoLayout场景：给ImageView添加「宽高相等」的约束，绑定widthAnchor等于heightAnchor，这样无论屏幕尺寸怎么变，它始终是正方形：

  profileImage.translatesAutoresizingMaskIntoConstraints = false
  NSLayoutConstraint.activate([
      profileImage.widthAnchor.constraint(equalTo: profileImage.heightAnchor),
      // 补充其他布局约束，比如top、leading等
  ])
  

• 手动设置Frame场景：直接保证frame.size.width和frame.size.height数值一致：

  profileImage.frame = CGRect(x: 40, y: 40, width: 120, height: 120)
  

2. 配置正确的Content Mode #

你之前改Content Mode没解决问题，大概率是没选对模式。要选UIViewContentMode.scaleAspectFill：

• 这个模式会让图片按比例缩放，直到完全填满整个ImageView的边界，超出的部分会被裁剪掉，刚好适配圆形的需求；
• 千万别用scaleAspectFit，这个模式是让图片完整显示在ImageView内，会自动留白，正是你遇到的问题。

设置代码：

profileImage.contentMode = .scaleAspectFill

3. 选对设置圆角的时机 #

如果你在viewDidLoad里设置圆角，这时候AutoLayout还没完成布局，ImageView的frame可能是初始默认值，导致圆角计算错误。建议把圆角设置代码放到viewDidLayoutSubviews中，这个方法会在布局完全完成后调用，能拿到准确的尺寸：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    profileImage.layer.cornerRadius = profileImage.frame.size.height / 2
    profileImage.clipsToBounds = true
}

额外补充：如果想保留图片完整内容 #

如果不想裁剪图片，又要让它填满圆形区域，那你需要先把图片预处理成正方形：

func squareImage(from image: UIImage) -> UIImage {
    let sideLength = min(image.size.width, image.size.height)
    let x = (image.size.width - sideLength) / 2
    let y = (image.size.height - sideLength) / 2
    let cropRect = CGRect(x: x, y: y, width: sideLength, height: sideLength)
    
    guard let cgImage = image.cgImage?.cropping(to: cropRect) else {
        return image
    }
    return UIImage(cgImage: cgImage)
}

// 使用时
profileImage.image = squareImage(from: yourOriginalImage)

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