无法从Objective-C的.m文件调用Swift扩展方法：无可见@interface

问题场景 #

我有一个拆分在.h和.m文件中的Objective-C类LocatorViewController，在Swift扩展中实现了一个方法，虽已在.h文件声明方法并导入了Xcode自动生成的桥接文件，但在.m文件中调用该方法时编译报错，必须添加空实现才能正常编译，想要找到更优的实现方式。

各文件代码内容 #

LocatorViewController.h

- (void)showSearchAreaButtonIfNeeded;

LocatorViewController.swift

@objc extension LocatorViewController {
    @objc func showSearchAreaButtonIfNeeded() { }
}

LocatorViewController.m调用及报错

#import <FindUsLegacy/FindUsLegacy-Swift.h> // Xcode自动生成，编译无问题

// 在某方法内调用
[self showSearchAreaButtonIfNeeded];

// 编译报错：No visible @interface for 'LocatorViewController' declares the selector 'showSearchAreaButtonIfNeeded:'

临时方案（待优化） #

在.m文件中添加空实现后，项目可编译，且实际执行的是Swift扩展中的方法（推测为动态调度导致）：

- (void)showSearchAreaButtonIfNeeded {}

但我认为无需添加该空实现，想确认是否有更优的解决方式。

最优解决方案 #

问题核心是Objective-C编译器的导入顺序与Swift桥接文件的生成时机不匹配——编译器解析主类头文件时，还未加载Swift到Objective-C的桥接内容，导致无法找到方法实现而报错。以下两种方式可解决：

方式1：用分类声明方法替代主类头文件声明 #

创建LocatorViewController+Search.h分类头文件：

#import "LocatorViewController.h"

@interface LocatorViewController (Search)
- (void)showSearchAreaButtonIfNeeded;
@end

在LocatorViewController.m中导入该分类头文件，不再在主类.h中声明方法。编译器会先处理分类的方法声明，再结合桥接文件找到Swift扩展中的实现，不会触发报错。

方式2：调整桥接文件的导入顺序 #

将桥接文件的导入语句移到.m文件的最顶部，早于主类头文件的导入：

#import <FindUsLegacy/FindUsLegacy-Swift.h>
#import "LocatorViewController.h"

// 此时调用[self showSearchAreaButtonIfNeeded]不会报错

调整后编译器会先加载Swift桥接内容（包含Swift扩展方法的Objective-C映射），再解析主类头文件的方法声明，从而关联到Swift扩展中的实现，无需添加空实现。

原理说明 #

Objective-C编译器按文件导入顺序逐行解析：

• 原顺序下，先导入主类头文件（包含方法声明），再导入桥接文件，编译器看到声明却找不到对应实现，因此报错；
• 调整顺序后，桥接文件先被加载，编译器已知晓Swift扩展方法的存在，再处理主类头文件的声明时，就能将两者关联，消除报错。

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