Swift子类化Charts框架MarkerView时Project-Swift.h编译报错

我最近碰到过一模一样的问题，当用Swift继承Charts框架的MarkerView时，自动生成的Objective-C头文件总是报编译错误，折腾了一阵终于找到解决办法，下面给你详细拆解：

问题场景还原 #

你的代码结构大概是这样的：

Swift子类代码（TestMV.swift） #

import UIKit
import Charts
class TestMV: MarkerView { }

Xcode自动生成的ProjectName-Swift.h里出现了这段代码：

SWIFT_CLASS("_TtC9KCTFunFit6TestMV")
@interface TestMV : ChartMarkerView
- (nonnull instancetype)initWithFrame:(CGRect)frame OBJC_DESIGNATED_INITIALIZER;
- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER;
@end

而Charts框架里MarkerView的定义是：

import Foundation
import CoreGraphics
import AppKit
@objc(ChartMarkerView)
open class MarkerView: NSUIView, IMarker {
    open var offset: CGPoint = CGPoint()
    @objc open weak var chartView: ChartViewBase?
    open func offsetForDrawing(atPoint point: CGPoint) -> CGPoint { ....... }
}

编译时，Project-Swift.h里的ChartMarkerView总是找不到定义，触发编译错误。

问题核心原因 #

本质是Objective-C与Swift跨平台视图类的兼容性冲突：

1. MarkerView继承的NSUIView是苹果为跨平台（iOS/macOS）设计的视图类，在iOS环境下它会映射到UIView，但Objective-C无法直接识别这种跨平台类的别名映射；
2. 自动生成的头文件引用了ChartMarkerView（即Swift中的MarkerView），但如果你的Objective-C代码没有正确导入Charts框架的头文件，编译器就找不到这个类的定义，直接报错。

可行解决方案 #

方案1：给Objective-C代码导入Charts头文件 #

如果你的项目需要在Objective-C中使用这个Swift子类，一定要在引用Project-Swift.h的Objective-C文件，或者项目的桥接文件中，手动导入Charts的Objective-C头文件：

#import <Charts/Charts.h>

这样编译器就能识别ChartMarkerView类，错误自然消失。

方案2：给Swift子类显式添加@objc注解 #

虽然MarkerView已经有@objc标记，但给你的子类也显式加上@objc并指定类名，能让自动生成的头文件更清晰，避免Swift内部命名转换带来的问题：

import UIKit
import Charts
@objc(TestMV)
class TestMV: MarkerView { }

方案3：限制子类访问级别（若不需要Objective-C调用） #

如果TestMV只在Swift代码里使用，完全不需要暴露给Objective-C，直接把它改成internal或者fileprivate级别，Xcode就不会把它加入到自动生成的Project-Swift.h里了：

import UIKit
import Charts
internal class TestMV: MarkerView { }

验证步骤 #

修改完成后，先clean项目（快捷键Cmd+Shift+K），再重新编译（Cmd+B），应该就能顺利通过编译了。

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