如何在SpriteKit中实现自定义Move动作并解决重复执行冲突

你的问题根源在于：初始实现里的lastElapsedTime是被同一个SKAction实例的所有执行共享的捕获变量，当同一节点同时运行该动作的多个实例时，多个闭包会同时读写这个变量，直接导致时间差计算错乱。

核心解决方案思路 #

放弃依赖增量位移的计算方式，改为基于动作执行进度直接计算目标位置，同时为每个动作执行实例保存独立的初始状态，彻底避免共享变量冲突。

具体实现代码 #

import SpriteKit

extension SKAction {
    static func moveX(by amount: CGFloat, duration: TimeInterval) -> SKAction {
        // 生成唯一键，确保每个动作实例的状态不冲突
        let stateKey = UUID().uuidString
        
        // 记录初始X位置（先初始化userData，避免nil崩溃）
        let recordInitialPos = SKAction.run { node in
            if node.userData == nil {
                node.userData = [:]
            }
            node.userData?[stateKey] = node.position.x
        }
        
        // 自定义位移动作：基于进度计算目标位置
        let moveAction = SKAction.customAction(withDuration: duration) { node, elapsedTime in
            guard let initialX = node.userData?[stateKey] as? CGFloat else { return }
            // 计算动作执行进度（自动适配非线性时间模式）
            let progress = elapsedTime / duration
            // 直接设置目标X位置，无需依赖上一次的时间记录
            node.position.x = initialX + amount * progress
        }
        
        // 动作结束后清理状态，避免userData冗余
        let cleanUpState = SKAction.run { node in
            node.userData?.removeValue(forKey: stateKey)
        }
        
        // 将三个步骤组合成序列动作
        return SKAction.sequence([recordInitialPos, moveAction, cleanUpState])
    }
}

方案优势 #

1. 无状态冲突：每个动作执行实例都用唯一键存储自己的初始位置，同一节点多次运行同一动作实例时不会互相干扰。
2. 适配非线性时间：基于elapsedTime计算进度，自动适配节点speed修改、场景时间缩放等非线性时间场景，位移计算始终准确。
3. 实现简洁可靠：无需维护复杂的状态映射，直接通过userData存储临时状态，动作结束后自动清理。

验证示例 #

用你给出的测试代码验证：

let move = SKAction.moveX(by: 5.0, duration: 1)
node.run(.group([move, .sequence([.wait(forDuration: 0.25), move])]))

此时两个move动作实例会各自独立计算位移，最终节点总共移动10个单位，和原生moveBy行为完全一致。

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