主VC、子VC与Subview的Z轴层级疑问：谁显示在最上层？

Great question—this gets at a common point of confusion with iOS view hierarchies and view controller containment. Let’s break this down clearly:

Core Answer #

By default, the last view you add via addSubview(_:) will sit at the top of the visual hierarchy for its parent view. In your case:

1. When you add a child view controller to your main VC, the system automatically adds the child’s view to the main VC’s view (behind the scenes, it’s equivalent to calling mainVC.view.addSubview(childVC.view)).
2. If you then call mainVC.view.addSubview(yourCustomView), yourCustomView is appended to the end of mainVC.view’s subviews list—meaning it should visually appear above the child VC’s view.

Why the Discrepancy Between View Debugger and Physical Device? #

Your observation that the view debugger shows yourCustomView on top but it’s invisible on-device is a common gotcha. Here are the most likely causes:

• Transparent/invisible subview: If yourCustomView has no background color set (or uses a fully transparent one), it’s technically on top but you can’t see it against the child VC’s view. Try setting a bright, opaque background color (e.g., .red) to test this.
• Layout issues: The subview might not be constrained correctly to fill the screen, so it’s positioned outside the visible bounds of the main VC’s view. The view debugger will show it off-screen, but you won’t see it on-device.
• Child VC view modifications: The child view controller might be adding additional subviews to its own view after you add your custom subview (e.g., in viewDidAppear), which would then sit on top of your custom view.

About Your Observation Needing to Add the Subview to the Child VC #

This isn’t the default behavior—something else is interfering with your custom subview’s visibility when added to the main VC. To troubleshoot:

1. Print the order of the main VC’s subviews right after adding your custom view:

   print(mainVC.view.subviews)
   

   If yourCustomView is the last item in the list, it’s definitely at the top of the hierarchy.
2. Check for properties like isHidden or alpha on yourCustomView that might be hiding it.
3. Ensure no other code is modifying the subview hierarchy (e.g., calling sendSubviewToBack(_:) on your custom view accidentally).

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