求助：为UIViewController的UIView添加渐变层不显示问题

这种情况我之前踩过好几次坑，明明代码看起来没问题，但渐变就是死活不出来，大概率是几个容易忽略的细节没做好，咱们一步步排查：

• 渐变层的frame没和视图bounds绑定
  你说视图frame正常，但渐变层的frame得用view.bounds而不是view.frame啊！尤其是在viewDidLoad里，视图的最终布局还没确定，用frame可能会导致渐变层大小不匹配。另外一定要加上自动适应的mask，不然视图大小变化（比如旋转屏幕）时渐变层会跟着跑偏：

  let gradientLayer = CAGradientLayer()
  gradientLayer.colors = [UIColor.cyan.cgColor, UIColor.blue.cgColor]
  gradientLayer.frame = view.bounds // 重点：用bounds而非frame
  gradientLayer.autoresizingMask = [.layerWidthSizable, .layerHeightSizable] // 自动适配宽高变化
  view.layer.insertSublayer(gradientLayer, at: 0)
  

• 渐变层被视图的backgroundColor覆盖了
  别小看view.backgroundColor！UIView的背景色其实是直接设置在它的layer上的，而layer的背景色会先于所有子层绘制。如果你的代码里先加了渐变层，又不小心设置了非透明的背景色（比如白色），虽然渐变层在背景色上方，但如果渐变颜色和背景色过于接近，或者渐变设置有问题，就会看起来像没显示。所以先把view.backgroundColor = .clear试试，排除这个干扰。

• colors参数类型错了
  这个真的太容易犯了！CAGradientLayer的colors数组必须是CGColor类型，要是你直接写[UIColor.red, UIColor.yellow]，编译器可能不会报错，但渐变就是不显示。一定要转成cgColor：[UIColor.red.cgColor, UIColor.yellow.cgColor]。

• 添加渐变层的时机不对
  如果在viewDidLoad里添加，此时视图的布局还没完全确定（比如有导航栏、tabBar的情况下，view的bounds会在后续生命周期方法里更新）。最好把添加渐变层的代码移到viewDidLayoutSubviews里，同时要避免重复添加层：

  override func viewDidLayoutSubviews() {
      super.viewDidLayoutSubviews()
      // 先清理已有的渐变层，防止重复添加
      view.layer.sublayers?.filter { $0 is CAGradientLayer }.forEach { $0.removeFromSuperlayer() }
      
      let gradientLayer = CAGradientLayer()
      gradientLayer.colors = [UIColor.green.cgColor, UIColor.gray.cgColor]
      gradientLayer.frame = view.bounds
      gradientLayer.autoresizingMask = [.layerWidthSizable, .layerHeightSizable]
      view.layer.insertSublayer(gradientLayer, at: 0)
  }
  

• 渐变层的插入层级不对
  如果你把渐变层插在了其他子层的上面，被其他视图挡住了也会看不到。用insertSublayer(_:at:0)是对的，确保它在所有子层的最底部。另外也可以再检查一下视图调试器里的layer层级，看看渐变层是不是真的被添加进去了——如果看不到，说明代码根本没执行到添加的逻辑？比如是不是加了判断条件没满足？

你可以先从这几个点排查，尤其是frame和colors类型的问题，大概率能解决！

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