iOS：Swift主工程调Objective-C子工程页面报错Cannot find type 'NameViewController'

Cannot find type 'NameViewController' in scope 本质是Swift主工程无法识别Objective-C子工程中的类，核心原因包括：

• Swift工程未配置与Objective-C子工程的桥接文件，或桥接文件未导入目标控制器的头文件
• 两个工程未建立正确依赖关系，Swift主工程编译时无法获取Objective-C子工程的编译产物
• Objective-C子工程的目标控制器头文件未公开，或子工程的模块配置未开启

1. 配置工程依赖 #

• 打开Swift主工程，进入Target的 Build Phases 面板
  • 在 Target Dependencies 中添加Objective-C子工程的Target，确保主工程编译时会优先编译子工程
  • 在 Link Binary With Libraries 中添加Objective-C子工程生成的产物（静态库选.a，动态库选.framework）

2. 配置Swift-OC桥接文件 #

• 若Swift主工程无桥接文件，新建一个（命名示例：MainProject-Bridging-Header.h）
• 进入主工程Target的 Build Settings，找到 Swift Compiler - General 下的 Objective-C Bridging Header，设置为桥接文件的路径（示例：$(SRCROOT)/MainProject-Bridging-Header.h）
• 在桥接文件中导入Objective-C子工程的目标控制器头文件：

#import "NameViewController.h"

注意：若Objective-C子工程是静态库，需确保NameViewController.h被添加到子工程的 Public Headers 列表中

3. 修正跳转代码 #

Objective-C子工程的Storyboard默认在自身Bundle中，需指定正确Bundle实例化控制器：

// 获取Objective-C子工程的Bundle
let ocSubBundle = Bundle(for: NameViewController.self)
// 从子工程的Storyboard实例化控制器
let storyboard = UIStoryboard(name: "Main", bundle: ocSubBundle)
guard let commonVC = storyboard.instantiateViewController(withIdentifier: "Main") as? NameViewController else {
    return
}
// 执行跳转（示例为push，可根据需求改为present）
navigationController?.pushViewController(commonVC, animated: true)

4. 关键配置检查 #

• 确保Objective-C子工程的 Build Settings 中，Defines Module 设置为 YES，Swift才能正确识别子工程模块
• 检查Storyboard的控制器Identifier与代码中instantiateViewController(withIdentifier:)的参数完全一致
• 清理工程（Cmd+Shift+K）后重新编译，避免缓存导致的识别问题

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