yauaa 因规则引擎+持续更新的 YAML 库，覆盖 95%+ UA，支持离线解析；而正则易漏新版UA，UADetector已停更、识别率低于40%。
为什么用 yauaa 而不是正则或 UADetector
因为 User-Agent 字符串没有标准格式，浏览器、手机、爬虫、IoT 设备各写各的，靠正则匹配会漏掉新版 Chrome、Edge Canary、鸿蒙 WebView 或微信内置浏览器；UADetector 已多年未更新，对 2023 年后发布的设备识别率低于 40%。而 yauaa（Yet Another UserAgent Analyzer）用规则引擎 + 持续更新的 YAML 规则库，能覆盖 95%+ 的真实 UA，且支持离线解析、无网络依赖。
怎么快速接入并解析出浏览器和操作系统
加 Maven 依赖后，初始化一次 UserAgentAnalyzer 实例（它是线程安全、可复用的），再调用 parse() 即可。别每次请求都 new 一个 analyzer——那会触发规则重加载，CPU 和内存开销陡增。
常见错误现象：OutOfMemoryError 或首次解析耗时 >500ms，基本都是因为反复构造 UserAgentAnalyzer。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 用
UserAgentAnalyzer.newBuilder().hideMatcherLoadStats().build()初始化，避免启动日志刷屏 - 浏览器名取
userAgent.getBrowserName()，不是getBrowserFamily()（后者返回 "Chrome"，前者返回 "Google Chrome"） - 操作系统取
userAgent.getOperatingSystemNameVersion()，它合并了 OS 名与版本号（如 "Windows 11"），比分开取getOperatingSystemName()+getOperatingSystemVersion()更可靠——某些安卓 WebView 不报版本，单独取 version 会是空字符串
UserAgentAnalyzer uaa = UserAgentAnalyzer.newBuilder()
.hideMatcherLoadStats()
.build();
UserAgent userAgent = uaa.parse("Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1");
System.out.println(userAgent.getBrowserName()); // 输出：Safari
System.out.println(userAgent.getOperatingSystemNameVersion()); // 输出：iOS 17.5
yauaa 的轻量模式和资源占用怎么控制
默认规则全量加载约 30MB 堆内存 + 200ms 启动时间。如果只关心浏览器和操作系统（不分析设备型号、渲染引擎、是否爬虫），可以裁剪规则：
立即学习“Java免费学习笔记（深入）”；
- 用
.withCache(10000)控制 LRU 缓存大小，避免缓存爆炸（默认无上限） - 加
.dropTests()跳过内置测试用例加载（节省 ~10% 启动时间） - 关键：传入自定义规则路径，只保留
Browser.yaml和OperatingSystem.yaml，删掉Device.yaml等无关文件——实测内存降至 8MB，启动缩至 40ms - 注意：规则文件必须放在 classpath 下且路径正确，否则 fallback 到默认全量规则，白忙活
遇到解析结果为 Unknown 怎么排查
不是库不行，大概率是 UA 字符串本身异常或规则没命中。先确认输入是否被截断（比如 Nginx 默认 limit 限制了 header 长度）、是否含非法字符（\u0000）、是否被代理抹除（如某些 CDN 返回空 UA）。
- 启用调试模式：
UserAgentAnalyzer.newBuilder().addResources("regexes.yaml").build()，然后看日志里有没有Matched rule #xxx或No rule matched - 用
userAgent.getAnyValue("agentName")查看底层原始字段，有时getBrowserName()是 Unknown，但getAnyValue("rawUserAgent")能看出端倪（比如全是空白或只有 "Mozilla/5.0"） - 安卓 WebView 的 UA 常缺关键标识，yauaa 依赖
WebView或Chrome字样才归类为浏览器；若 UA 里只有Mobile Safari却跑在安卓上，结果就是 Unknown —— 这属于数据源问题，得前端补发特征字段
UserAgentAnalyzer 当成工具类反复实例化，以及默认全量规则在容器环境里悄悄吃光内存。真要上线，务必做裁剪 + 缓存 + 复用。 
