Clang为何在自动生成的Objective-C头文件中给参数名加下划线后缀？

这是编译器的文档化行为，并非临时实现细节，核心是为了解决Swift与Objective-C/C的语法兼容性问题，具体原因如下：

核心原因：规避C/Objective-C保留字冲突 #

Objective-C是C的超集，你提到的template、consteval属于C++关键字，同时也是C/Objective-C体系中的保留字——这类词汇不能直接用作变量、参数名，否则Objective-C编译器会抛出语法错误。

Swift语法设计更灵活，允许开发者用这类关键字做参数名，但当Swift代码通过@objc/@objcMembers暴露给Objective-C时，必须做命名转换：通过在末尾添加下划线的方式规避语法冲突，确保生成的[Project]-Swift.h头文件能被Objective-C正常编译。

为什么init参数未被修改？ #

例子里的init参数没有加下划线，是因为init在Objective-C中是特殊的方法名，但作为方法参数名时是合法的，不属于语法层面的保留字冲突，因此无需转义处理。

这是文档化行为的依据 #

Swift官方文档明确说明，将Swift API暴露给Objective-C时，编译器会自动调整与C/Objective-C保留字冲突的名称，添加下划线是标准的冲突解决规则，属于可预测、有明确设计意图的行为，而非未公开的实现细节。

代码示例验证 #

Swift源码 #

@objcMembers class SomeClass: NSObject {
    func someMethod(init: String) {}

    // ↓ 这些参数在头文件中会被追加下划线
    func someMethod(template: String) {}
    func someMethod(consteval: String) {}
}

生成的Objective-C头文件代码 #

SWIFT_CLASS("_TtC9iOSTester9SomeClass")
@interface SomeClass : NSObject
- (void)someMethodWithInit:(NSString * _Nonnull)init;
- (void)someMethodWithTemplate:(NSString * _Nonnull)template_;
- (void)someMethodWithConsteval:(NSString * _Nonnull)consteval_;
- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
@end

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