Swift：iPad端UIImageView无法保持1:1比例问题求助

我之前在适配iPad的时候也踩过这个UIImagePicker裁剪的坑，给你分享几个能解决问题的方案：

你的UIImageView出现黑边，是因为默认的contentMode不是填充裁剪模式。只需要调整两个属性，再配合正方形约束就能解决：

// 确保UIImageView是正方形（比如设置width = height的约束）
imageView.contentMode = .scaleAspectFill // 按比例填充视图，超出部分会被裁剪
imageView.clipsToBounds = true // 开启裁剪，隐藏超出视图范围的内容

这样设置后，不管图片是什么比例，都会填满正方形的UIImageView，不会出现黑边。

系统自带的UIImagePicker在iPad上的编辑模式确实不会强制显示正方形裁剪框（和iPhone端的逻辑不一样），所以有两种靠谱的解决方式：

方案一：手动裁剪选中的原图（无需第三方库） #

关闭系统的编辑功能，自己拿到原图后裁剪成1:1正方形，简单直接：

首先修改你的picker初始化代码，把allowsEditing设为false：

let picker = UIImagePickerController()
picker.allowsEditing = false // 关闭系统编辑
picker.sourceType = .photoLibrary
picker.delegate = self
if let popoverPicker = picker.popoverPresentationController {
    popoverPicker.sourceView = imageView
}
present(picker, animated: true, completion: nil)

然后在代理方法里处理图片裁剪：

func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
    picker.dismiss(animated: true)
    
    // 获取用户选中的原图
    guard let originalImage = info[.originalImage] as? UIImage else {
        print("无法获取图片")
        return
    }
    
    // 裁剪成1:1正方形
    let squareImage = cropToSquare(image: originalImage)
    
    // 更新UIImageView显示
    imageView.image = squareImage
    
    // 保存裁剪后的图片到相册（如果需要）
    UIImageWriteToSavedPhotosAlbum(squareImage, self, #selector(imageSavedCallback(_:error:context:)), nil)
}

// 自定义裁剪方法
private func cropToSquare(image: UIImage) -> UIImage {
    // 取图片宽高中的较小值作为正方形的边长
    let sideLength = min(image.size.width, image.size.height)
    
    // 计算裁剪区域的原点，保证裁剪后的图片居中
    let originX = (image.size.width - sideLength) / 2
    let originY = (image.size.height - sideLength) / 2
    let cropRect = CGRect(x: originX, y: originY, width: sideLength, height: sideLength)
    
    // 执行裁剪并返回新图片
    guard let croppedCGImage = image.cgImage?.cropping(to: cropRect) else {
        return image // 裁剪失败则返回原图
    }
    return UIImage(cgImage: croppedCGImage, scale: image.scale, orientation: image.imageOrientation)
}

// 图片保存回调
@objc private func imageSavedCallback(_ image: UIImage, error: Error?, context: UnsafeRawPointer) {
    if let error = error {
        print("图片保存失败：\(error.localizedDescription)")
    } else {
        print("图片已成功保存")
    }
}

方案二：用自定义裁剪界面（更贴近iPhone端交互） #

如果你想要和iPhone一样的交互式正方形裁剪体验，可以用成熟的第三方库，比如TOCropViewController，它支持在iPad上以popover形式展示，并且能强制锁定1:1比例：

首先在Podfile里添加依赖：

pod 'TOCropViewController'

然后实现代码：

import TOCropViewController

// 弹出图片选择器
func presentImagePicker() {
    let picker = UIImagePickerController()
    picker.sourceType = .photoLibrary
    picker.delegate = self
    if let popover = picker.popoverPresentationController {
        popover.sourceView = imageView
    }
    present(picker, animated: true)
}

// 选择图片后弹出裁剪控制器
func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
    picker.dismiss(animated: true)
    
    guard let originalImage = info[.originalImage] as? UIImage else { return }
    
    // 初始化裁剪控制器，强制正方形比例
    let cropVC = TOCropViewController(image: originalImage)
    cropVC.aspectRatioPreset = .presetSquare
    cropVC.aspectRatioLockEnabled = true // 锁定比例，用户无法调整为矩形
    cropVC.delegate = self
    
    // iPad上设置popover展示
    if let popover = cropVC.popoverPresentationController {
        popover.sourceView = imageView
    }
    
    present(cropVC, animated: true)
}

// 裁剪完成回调
func cropViewController(_ cropViewController: TOCropViewController, didCropTo image: UIImage, with cropRect: CGRect, angle: Int) {
    cropViewController.dismiss(animated: true)
    imageView.image = image
    // 保存裁剪后的图片
    UIImageWriteToSavedPhotosAlbum(image, self, #selector(imageSavedCallback(_:error:context:)), nil)
}

• UIImageView的黑边问题通过scaleAspectFill + clipsToBounds就能彻底解决，记得给视图加上正方形约束。
• 系统UIImagePicker在iPad上没有强制正方形裁剪的选项，要么手动裁剪原图，要么用第三方裁剪库实现交互式裁剪，两种方式都能达到你想要的效果。

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