为何UIPanGestureRecognizer的location(in:)返回坐标超出视图边界？

这个问题我之前做图片取色功能时也踩过坑，大概率是坐标系转换或者视图配置的问题，咱们一步步拆解清楚：

一、为什么坐标会超出imageView的边界？ #

常见的几个诱因：

• 参考坐标系选错了：如果调用gesture.location(in:)时传入的是父视图（比如self.view），返回的坐标是相对于父视图的，而非imageView本身。比如你的imageView宽度是375，但父视图（比如iPhone 11的屏幕）宽度是414，拖动到屏幕右侧时x坐标自然会接近414，超出imageView的范围。
• 视图有缩放/变换：如果imageView嵌套在支持缩放的UIScrollView里，或者给imageView设置了transform（比如缩放、旋转），gesture.location(in: imageView)返回的是经过变换后的视图坐标系坐标，会因为缩放比例被“拉伸”，超出原始frame的范围。
• contentMode导致显示与图片尺寸不匹配：比如设置了.scaleAspectFill时，图片会被拉伸填满imageView，但图片本身的像素尺寸和imageView的frame尺寸不一致，即使坐标在frame范围内，直接用它取色也会出错，更别说坐标超出的情况。

二、针对性解决方法 #

1. 确保获取的是imageView自身的坐标 #

先检查代码里的location(in:)参数，一定要传入你的imageView实例，而不是父视图：

let touchPoint = gesture.location(in: yourImageView)

这样返回的坐标是以imageView左上角为原点的bounds坐标系坐标，正常范围应该是0 ≤ x ≤ yourImageView.bounds.width、0 ≤ y ≤ yourImageView.bounds.height。

2. 处理缩放/变换场景 #

如果是UIScrollView嵌套的缩放场景，需要把手势坐标转换为图片本身的像素坐标：

guard let scrollView = yourImageView.superview as? UIScrollView else { return }
let touchPointInView = gesture.location(in: yourImageView)
let scale = scrollView.zoomScale
// 转换为图片像素坐标
let imagePixelPoint = CGPoint(x: touchPointInView.x * scale, y: touchPointInView.y * scale)

如果是imageView自身设置了transform，用convert(_:to:)转换到无变换的坐标系：

let touchPoint = gesture.location(in: yourImageView)
let originalPoint = yourImageView.convert(touchPoint, to: yourImageView.superview)

3. 正确转换坐标到图片像素（核心步骤） #

不管有没有缩放，取色前都要把手势坐标转换为图片的像素坐标，因为imageView的frame和图片像素尺寸往往不一致：

guard let image = yourImageView.image else { return }
let imageSize = image.size
let viewSize = yourImageView.bounds.size

// 根据contentMode计算缩放比例
let scaleX = imageSize.width / viewSize.width
let scaleY = imageSize.height / viewSize.height
let finalScale: CGFloat

switch yourImageView.contentMode {
case .scaleAspectFit:
    finalScale = min(scaleX, scaleY)
case .scaleAspectFill:
    finalScale = max(scaleX, scaleY)
default:
    finalScale = 1.0
}

// 计算图片上的实际像素点（考虑contentMode的偏移）
let touchPoint = gesture.location(in: yourImageView)
let xOffset = (imageSize.width - viewSize.width * finalScale) / 2
let yOffset = (imageSize.height - viewSize.height * finalScale) / 2
let imagePixelX = touchPoint.x * finalScale + xOffset
let imagePixelY = touchPoint.y * finalScale + yOffset

// 最后确保坐标在图片范围内，避免越界
guard imagePixelX >= 0, imagePixelX < imageSize.width,
      imagePixelY >= 0, imagePixelY < imageSize.height else {
    // 坐标越界，跳过取色
    return
}

额外检查 #

在手势回调里打印imageView的实际bounds和触摸坐标，确认是否真的超出范围：

print("ImageView实际bounds: \(yourImageView.bounds)")
print("触摸坐标: \(touchPoint)")

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