Swift下Texture节点快照测试问题：仅捕获基础节点

先排查最容易忽略的点：子节点管理 #

首先检查你的自定义ASDisplayNode子类有没有设置automaticallyManagesSubnodes = true——这是Texture节点自动管理布局树中子节点的关键开关。如果没开，哪怕你在layoutSpecThatFits里返回了包含子节点的布局spec，这些子节点也不会被添加到节点的子层级，自然不会出现在快照里：

class YourCustomNode: ASDisplayNode {
    override init() {
        super.init()
        automaticallyManagesSubnodes = true // 必须设置！
    }

    override func layoutSpecThatFits(_ constrainedSize: ASSizeRange) -> ASLayoutSpec {
        // 这里返回包含子节点的布局，比如Stack、Inset等
        let stack = ASStackLayoutSpec(direction: .vertical, spacing: 12, children: [yourChildNode1, yourChildNode2])
        return ASInsetLayoutSpec(insets: UIEdgeInsets(top: 16, left: 16, bottom: 16, right: 16), child: stack)
    }
}

解决异步布局的快照时机问题 #

Texture的布局是异步执行的，而swift-snapshot-testing默认是同步快照，很可能在布局逻辑跑完前就拍了照。你之前加延迟没用，是因为延迟时间不一定能覆盖布局耗时，而且不够可靠。用XCTest的期望机制等待布局完成才是正确做法：

func testYourNodeSnapshot() {
    // 1. 创建节点并设置初始尺寸
    let testNode = YourCustomNode()
    let testSize = CGSize(width: 375, height: 667)
    testNode.frame = CGRect(origin: .zero, size: testSize)

    // 2. 把节点加到窗口里，确保它在视图层级中（Texture需要这个触发完整布局）
    let window = UIWindow(frame: testNode.frame)
    window.addSubnode(testNode)
    window.makeKeyAndVisible()

    // 3. 等待布局完成
    let layoutDone = expectation(description: "Texture layout finished")
    testNode.layoutCompletionBlock = { _ in
        layoutDone.fulfill()
    }

    // 4. 手动触发布局
    testNode.setNeedsLayout()
    testNode.layoutIfNeeded()

    // 5. 等待布局完成后再快照
    waitForExpectations(timeout: 3, handler: nil)

    // 执行快照（如果直接拍节点不行，试试拍testNode.view）
    assertSnapshot(matching: testNode, as: .image)
}

备选方案：手动测量+延迟兜底 #

如果上面的布局完成回调没触发，可以手动触发节点测量，再用短延迟确保异步布局收尾：

func testYourNodeSnapshot() {
    let testNode = YourCustomNode()
    // 手动测量节点的合适尺寸
    let sizeRange = ASSizeRangeMake(CGSize(width: 375, height: .infinity), CGSize(width: 375, height: .infinity))
    let measuredSize = testNode.measure(sizeRange)
    testNode.frame = CGRect(origin: .zero, size: measuredSize)

    let window = UIWindow(frame: testNode.frame)
    window.addSubnode(testNode)
    window.makeKeyAndVisible()

    // 用延迟兜底等待布局完成
    let layoutDone = expectation(description: "Layout done")
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
        layoutDone.fulfill()
    }

    testNode.setNeedsLayout()
    testNode.layoutIfNeeded()

    waitForExpectations(timeout: 2, handler: nil)
    assertSnapshot(matching: testNode.view, as: .image)
}

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