如何为UIView添加左上至右下渐变？代码调用无显示问题解决

你的核心渐变逻辑是对的，但渐变不显示大概率是调用时机错误或自定义颜色无效导致的，以下是修正后的可靠实现：

一、优先排查项 #

• 先替换自定义颜色为系统颜色（比如UIColor.red、UIColor.blue）测试，确认是否是UIColor.style.negativeGradient/negative没有生成有效的CGColor。
• 不要在viewDidLoad中直接调用渐变方法，此时mainView的布局还未完成，bounds宽高可能为0。

二、修正后的代码实现 #

方式1：控制器内适配布局变化的实现 #

class YourViewController: UIViewController {
    private var gradientLayer: CAGradientLayer?
    @IBOutlet weak var mainView: UIView!

    override func viewDidLoad() {
        super.viewDidLoad()
        setupGradientLayer()
    }

    private func setupGradientLayer() {
        let gradient = CAGradientLayer()
        gradient.startPoint = CGPoint(x: 0.0, y: 0.0)
        gradient.endPoint = CGPoint(x: 1.0, y: 1.0)
        // 先测试系统颜色，确认有效后再换回自定义颜色
        gradient.colors = [UIColor.red.cgColor, UIColor.blue.cgColor]
        mainView.layer.addSublayer(gradient)
        gradientLayer = gradient
    }

    override func viewDidLayoutSubviews() {
        super.viewDidLayoutSubviews()
        // 布局完成后更新渐变层尺寸
        gradientLayer?.frame = mainView.bounds
    }
}

方式2：UIView扩展封装（复用性更强） #

extension UIView {
    func addTopLeftToBottomRightGradient(from startColor: UIColor, to endColor: UIColor) {
        let gradient = CAGradientLayer()
        gradient.startPoint = CGPoint(x: 0, y: 0)
        gradient.endPoint = CGPoint(x: 1, y: 1)
        gradient.colors = [startColor.cgColor, endColor.cgColor]
        gradient.frame = self.bounds
        // 将渐变层插入最底层，避免覆盖其他子视图
        self.layer.insertSublayer(gradient, at: 0)
        
        // 监听视图尺寸变化，自动更新渐变层
        self.addObserver(self, forKeyPath: #keyPath(bounds), options: .new, context: nil)
    }
    
    override open func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        guard keyPath == #keyPath(bounds),
              let gradient = self.layer.sublayers?.first(where: { $0 is CAGradientLayer }) as? CAGradientLayer else {
            super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
            return
        }
        gradient.frame = self.bounds
    }
}

调用示例（在viewDidLayoutSubviews或viewDidAppear中执行）：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    mainView.addTopLeftToBottomRightGradient(from: UIColor.style.negativeGradient, to: UIColor.style.negative)
}

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