iOS与Android枚举内容同步方案咨询及自定义Linter开发指导需求

一、可行替代方案 #

• 单一数据源自动生成代码：维护一份JSON/YAML格式的枚举定义源文件（比如analytics_events.yaml），枚举所有事件类型的字符串值。编写轻量脚本（Python/Node.js均可），读取这份源文件自动生成Swift和Kotlin的枚举代码。所有枚举变更只修改源文件，再执行生成脚本即可——从根源避免双平台代码不一致，同时不改变开发者使用原生枚举的习惯。
• Git钩子即时校验：在项目中添加pre-commit或pre-push钩子脚本，提交/推送代码前自动对比两个枚举文件的字符串值集合。如果发现不一致，直接阻断操作并提示差异内容，让开发者在本地就修正问题。
• CI流水线集成检查：把枚举一致性校验加入CI流程（如GitHub Actions、GitLab CI），每次代码提交时自动执行检查脚本。一旦出现不一致，标记构建失败，确保只有符合一致性要求的代码能合并到主分支。

二、自定义Linter开发思路 #

Swift端解析 #

可以基于SwiftSyntax框架实现精准解析：通过遍历Swift文件的抽象语法树（AST），定位到EventType枚举节点，提取每个case对应的原始字符串值。这种方式能适配复杂的Swift枚举语法，避免正则匹配的局限性。

Kotlin端解析 #

• 用Kotlin Compiler API解析Kotlin文件，遍历枚举类的成员，提取每个常量的value属性值，适合需要处理复杂Kotlin语法的场景。
• 如果枚举格式固定（像示例中那样的简单结构），也可以用正则表达式快速提取：匹配\w+\("([^"]+)"\)格式，捕获括号内的字符串值。

跨平台校验脚本 #

用通用脚本语言（Python/Node.js）实现轻量校验逻辑，示例逻辑如下：

# 示例Python脚本片段
import re

def extract_swift_enum_values(file_path):
    with open(file_path, 'r') as f:
        content = f.read()
    return set(re.findall(r'case \w+ = "([^"]+)"', content))

def extract_kotlin_enum_values(file_path):
    with open(file_path, 'r') as f:
        content = f.read()
    return set(re.findall(r'\w+\("([^"]+)"\)', content))

swift_values = extract_swift_enum_values('AnalyticsConstants.swift')
kotlin_values = extract_kotlin_enum_values('AnalyticsConstants.kt')

if swift_values != kotlin_values:
    print("枚举值不一致：")
    print(f"Swift独有的值：{swift_values - kotlin_values}")
    print(f"Kotlin独有的值：{kotlin_values - swift_values}")
    exit(1)
else:
    print("枚举值一致")

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