Swift：如何实现UIImageView的随机移动动画？

第一步：确认IBOutlet关联有效性 #

• 在你的updatePosition方法开头添加调试代码，检查控件是否正确关联：

  guard let targetImageView = yourImageViewOutlet else {
      print("UIImageView未正确关联到IBOutlet")
      return
  }
  

  运行后如果控制台输出UIImageView未正确关联到IBOutlet，说明storyboard/xib中的控件和代码变量没有正确连线：
  1. 打开storyboard/xib，找到对应的UIImageView
  2. 右键点击控件，检查"Referencing Outlets"是否包含你的代码变量，没有的话重新拖拽连线
  3. 确保代码中的IBOutlet变量没有被误删或重命名

第二步：修正动画实现逻辑 #

你用transform做平移动画时，容易出现覆盖原有变换的问题（比如每次都基于初始位置平移，而非当前位置），推荐两种更可靠的实现方式：

方式1：修改center属性（最直观，适配自动布局） #

func updatePosition() {
    guard let imageView = yourImageViewOutlet else { return }
    
    let screenBounds = UIScreen.main.bounds
    // 计算目标位置，确保视图不会超出屏幕
    let maxX = screenBounds.width - imageView.bounds.width
    let maxY = screenBounds.height - imageView.bounds.height
    let targetX = CGFloat.random(in: 0...maxX) + imageView.bounds.width/2
    let targetY = CGFloat.random(in: 0...maxY) + imageView.bounds.height/2
    
    UIView.animate(withDuration: 1.5, delay: 0, options: .curveEaseInOut) {
        imageView.center = CGPoint(x: targetX, y: targetY)
    } completion: { _ in
        // 如需连续随机移动，递归调用方法
        self.updatePosition()
    }
}

方式2：正确使用transform（基于当前变换叠加） #

如果坚持用transform，需要基于当前视图的变换矩阵叠加新的平移，而不是直接设置新的变换：

func updatePosition() {
    guard let imageView = yourImageViewOutlet else { return }
    
    let screenBounds = UIScreen.main.bounds
    let currentFrame = imageView.frame
    // 计算相对于当前位置的偏移量
    let offsetX = CGFloat.random(in: -50...50)
    let offsetY = CGFloat.random(in: -50...50)
    // 确保移动后不超出屏幕
    let targetX = max(0, min(currentFrame.origin.x + offsetX, screenBounds.width - currentFrame.width))
    let targetY = max(0, min(currentFrame.origin.y + offsetY, screenBounds.height - currentFrame.height))
    
    let translationX = targetX - currentFrame.origin.x
    let translationY = targetY - currentFrame.origin.y
    // 叠加变换
    let newTransform = imageView.transform.concatenating(CGAffineTransform(translationX: translationX, y: translationY))
    
    UIView.animate(withDuration: 1.0) {
        imageView.transform = newTransform
    } completion: { _ in
        self.updatePosition()
    }
}

第三步：确保动画方法被正确调用 #

• 不要在viewDidLoad中调用updatePosition，此时视图还未完成布局，坐标可能不正确
• 在viewDidAppear(_:)中调用，保证视图已经完成布局：

  override func viewDidAppear(_ animated: Bool) {
      super.viewDidAppear(animated)
      updatePosition()
  }
  

额外排查点 #

• 检查UIImageView是否被其他视图遮挡（在storyboard中调整视图层级）
• 如果使用自动布局，确保没有约束覆盖了你的动画修改（可以临时将imageView.translatesAutoresizingMaskIntoConstraints = true测试）
• 检查动画的duration是否设置为0，导致没有动画效果

内容的提问来源于stack exchange，提问作者Elias A.C