React Native与Swift桥接时为何第二个参数需添加标签？

这个问题的核心在于Swift与Objective-C的方法名映射规则差异，以及React Native的RCT_EXTERN_MODULE宏对Objective-C方法签名的严格匹配要求，下面一步步拆解：

1. Swift到Objective-C的方法签名转换逻辑 #

Swift和Objective-C的方法命名规则有本质区别：

• 对于Swift的方法，第一个参数默认省略外部标签，所以你的原始Swift方法：

  @objc func exampleMethod(_ message: String, _ properties: [String: Any]? = nil) -> Void {}
  

  被转换为Objective-C方法后，签名是：

  - (void)exampleMethod:(NSString *)message :(NSDictionary *)properties;
  

  注意第二个参数前面只有冒号，没有参数名（这在Objective-C里是合法但非常规的写法）。

• 当你给第二个参数添加withProperties标签后，Swift方法变为：

  @objc func exampleMethod(_ message: String, withProperties properties: [String: Any]? = nil) -> Void {}
  

  对应的Objective-C方法签名就变成了符合常规写法的：

  - (void)exampleMethod:(NSString *)message withProperties:(NSDictionary *)properties;
  

2. RCT_EXTERN_METHOD的匹配要求 #

React Native的RCT_EXTERN_METHOD宏是用来将Objective-C方法暴露给JS层的，它需要严格匹配Objective-C的完整方法签名：

• 你最初的头文件声明：

  RCT_EXTERN_METHOD(exampleMethod:(NSString *)name (NSDictionary *)properties)
  

  这种写法不符合Objective-C的方法语法（每个参数必须是参数名:的形式），宏无法匹配到Swift生成的exampleMethod::双冒号方法，所以JS调用时会抛出“未识别方法”的错误。

• 当你同步修改头文件声明为：

  RCT_EXTERN_METHOD(exampleMethod:(NSString *)name withProperties:(NSDictionary *)properties)
  

  此时宏就能准确匹配到带有参数标签的Objective-C方法，JS调用自然恢复正常。

3. 为什么第一个参数不需要标签？ #

因为Swift默认省略第一个参数的外部标签，对应的Objective-C方法签名中，第一个参数是紧跟在方法名后的:（比如exampleMethod:），这和你头文件里的exampleMethod:(NSString *)name声明完全匹配，所以不需要额外添加标签就能被正确识别。

总结来说，问题的根源是Swift无标签参数在Objective-C中会生成非常规的方法签名，而React Native的桥接宏只支持符合Objective-C常规写法的方法签名，因此第二个参数必须添加标签来生成合法的、可被匹配的方法名。

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