Swift中Cannot find type 'ViewController' in scope问题及代理传参求助

错误原因分析 #

出现Cannot find type 'ViewController' in scope的核心原因有两个：

1. ViewController类的访问权限问题：如果两个ViewController在不同文件中，ViewController被标记为private/fileprivate，或者第二个VC的文件无法访问到ViewController的定义；
2. 代理逻辑完全搞反：原代码试图让第二个VC作为代理赋值给第一个VC，这违背了代理模式的基本逻辑。

修复步骤与正确代码实现 #

1. 第一个ViewController（数据接收方）代码 #

import UIKit

// 定义代理协议，声明数据传递方法
protocol SwitchDelegate: AnyObject {
    func switchDidChangeValue(_ value: Bool)
}

class ViewController: UIViewController, SwitchDelegate {
    // 实现代理方法，接收第二个VC传递的开关状态
    func switchDidChangeValue(_ value: Bool) {
        // 在这里处理接收到的开关值，比如更新本地UI或业务逻辑
        print("开关状态更新为：\(value)")
    }

    // 跳转到第二个VC的触发方法（示例为按钮点击，可根据需求调整）
    @IBAction func navigateToSecondVC(_ sender: UIButton) {
        let storyboard = UIStoryboard(name: "KeyboardStoryboard", bundle: nil)
        // 安全解包避免崩溃
        guard let secondVC = storyboard.instantiateViewController(withIdentifier: "SecondVC") as? KeyboardViewController else {
            print("无法实例化SecondVC")
            return
        }
        // 设置第二个VC的代理为当前ViewController
        secondVC.delegate = self
        navigationController?.pushViewController(secondVC, animated: true)
    }
}

2. 第二个ViewController（数据发送方）代码 #

import UIKit

class KeyboardViewController: UIViewController {
    // 定义弱引用代理属性，避免循环引用
    weak var delegate: SwitchDelegate?

    // 开关状态变化的触发方法
    @IBAction func switchValueChanged(_ sender: UISwitch) {
        // 通过代理方法将开关状态传递给第一个VC
        delegate?.switchDidChangeValue(sender.isOn)
        // 如果需要操作后返回上一页，可添加：
        // navigationController?.popViewController(animated: true)
    }
}

关键注意事项 #

• 访问权限：确保ViewController和SwitchDelegate都保持默认的internal访问权限（不添加private修饰符），这样其他文件才能访问；
• 避免循环引用：代理属性必须用weak修饰，因为UIViewController本身会被navigationController强引用，代理如果强引用会导致内存泄漏；
• 安全解包：用guard let替代强制解包as!，避免因storyboard ID或类名不匹配导致崩溃；
• 代理逻辑：数据接收方（第一个VC）实现代理协议，数据发送方（第二个VC）持有代理属性，触发事件时调用代理方法传递数据。

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