# User-Agent 解析器使用教程：在线解析 UA 识别浏览器系统设备与爬虫

> 来源：工具派（https://gjupai.com） 原文页面：https://gjupai.com/tutorial/user-agent-parser-guide

## 工具简介

**User-Agent 解析器**是工具派推出的一款免费在线 UA 分析工具：把一段 User-Agent 字符串粘贴到输入框，页面就会立刻把它拆解成浏览器、渲染引擎、操作系统、设备类型、设备厂商、设备型号、CPU 架构、是否爬虫等结构化信息，每项结果都能单独复制，还能一键导出纯文本或 JSON。打开页面时工具会自动填入并解析你当前浏览器的 UA，整个过程完全在浏览器本地完成，UA 字符串不会上传到服务器，是做浏览器兼容性排查、爬虫识别、日志分析的顺手利器，无需安装、打开即用。

## 功能亮点

- **打开即用，自动解析本机 UA**：进入页面后自动读取 `navigator.userAgent` 填入输入框并完成解析，无需任何操作就能看到自己浏览器的完整信息。
- **输入即解析，零按钮操作**：在文本框中粘贴或修改任意 UA 字符串，解析结果实时刷新，不需要点击「解析」按钮；清空输入框则结果区自动隐藏。
- **八项结构化结果**：浏览器（含版本号）、渲染引擎（含内核版本）、操作系统（含版本号）、设备类型、设备厂商、设备型号、CPU 架构、是否爬虫，以卡片网格清晰展示。
- **18 种爬虫 / 机器程序识别**：内置 Googlebot、Bingbot、Baiduspider、YandexBot、Sogou、GPTBot、ClaudeBot、PerplexityBot、Bytespider、AhrefsBot、SemrushBot 等规则，还能识别 curl、wget、python-requests、Scrapy 等通用程序；命中时「是否爬虫」卡片以橙色高亮并标注具体爬虫名称。
- **4 个示例 UA 一键填入**：内置 Chrome（Windows 桌面）、Android（三星手机）、Googlebot、GPTBot 四条典型示例，点一下即可查看不同类型 UA 的解析效果。
- **三种复制方式**：每个结果卡片右侧都有独立「复制」按钮；底部「复制全部解析结果」导出多行纯文本（含平台类型与原始 UA），「复制 JSON」导出结构化 JSON（含 `isMobile`、`isTablet`、`isDesktop`、`isBot` 等布尔字段）。

## 参数说明

| 参数 | 说明 | 默认值 / 取值范围 |
| --- | --- | --- |
| User-Agent 字符串 | 待解析的 UA 文本，粘贴或修改后自动实时解析 | 默认自动填入当前浏览器的 UA |
| 使用当前浏览器 UA | 按钮，重新读取并填入当前浏览器的 UA 字符串 | 随时可点击 |
| 示例 UA | 一键填入内置示例，快速体验不同场景的解析结果 | Chrome、Android、Googlebot、GPTBot 共 4 条 |
| 单项「复制」按钮 | 每个结果卡片及「原始 UA」区域右侧的复制按钮，仅复制该项内容 | 8 个结果卡片 + 原始 UA |
| 复制全部解析结果 | 按钮，导出全部字段的多行纯文本，末尾附带平台类型（Mobile / Tablet / Desktop）与原始 UA | 解析有结果时可用 |
| 复制 JSON | 按钮，导出包含 browser、engine、os、deviceType、vendor、model、arch、isBot、botType、isMobile、isTablet、isDesktop、raw 字段的格式化 JSON | 解析有结果时可用 |

## 使用步骤

1. **打开工具页面**：页面顶部是工具标题与简介，下方主卡片就是全部功能区——上方是 UA 输入框，中间是示例按钮，下方是解析结果区。打开页面时输入框已自动填入你当前浏览器的 UA 并完成解析。

![User-Agent 解析器主界面：顶部为工具标题与简介卡片；主卡片上方是已自动填入本机 UA 的「User-Agent](article/202607/1783995033578_5731.png)

2. **查看本机解析结果**：不做任何操作，直接浏览结果卡片即可——例如截图中解析出「Chrome 149.0.0.0、WebKit (537.36)、Windows 10.0、Desktop、x86_64、是否爬虫：否」。

3. **解析指定 UA 字符串**：把从日志、抓包或代码中拿到的 UA 字符串粘贴进输入框，结果区会随输入实时刷新，无需点击任何按钮。

4. **试用示例 UA（可选）**：点击「示例」行中的 Chrome、Android、Googlebot、GPTBot 按钮，一键填入对应 UA，快速对比桌面浏览器、手机浏览器与搜索引擎爬虫的解析差异；想回到本机 UA 时点「使用当前浏览器 UA」即可。

5. **复制需要的结果**：只要某个字段就点该卡片右侧的「复制」；要完整结果就点底部「复制全部解析结果」得到纯文本，或点「复制 JSON」得到结构化数据，方便粘贴到代码、文档或工单中。

## 使用技巧

- **排查兼容性问题先复制 JSON**：「复制 JSON」中包含 `isMobile`、`isTablet`、`isDesktop`、`isBot` 等布尔字段，直接贴给同事或写进 issue，比口述「我是安卓手机」准确得多。
- **确认爬虫身份看橙色卡片**：解析结果中「是否爬虫」为「是」时卡片会变成橙色并显示具体爬虫名（如 Googlebot、GPTBot），分析网站日志时可以快速确认来访者是搜索引擎、AI 爬虫还是脚本程序。
- **识别手机型号看「设备型号」**：Android 设备的 UA 通常带有机型码（如三星 `SM-S918B`），工具会把它提取到「设备型号」和「设备厂商」字段；iPhone / iPad 则会识别出 Apple 厂商与对应型号。
- **用「使用当前浏览器 UA」快速复位**：试了一堆示例或粘贴了乱七八糟的字符串后，点一下这个按钮就能立刻回到本机 UA，不用刷新页面。
- **结合原始 UA 一起存档**：「复制全部解析结果」导出的文本末尾附带原始 UA 字符串，排查问题时把这份文本完整保存，后续任何人都能重新核对解析依据。

## 常见问题

**Q1：解析结果会上传到服务器吗？**
不会。整个解析过程完全在你自己的浏览器里用 JavaScript 本地完成，粘贴的 UA 字符串不会发送到任何服务器，可以放心解析内部系统的 UA。

**Q2：能识别哪些浏览器和系统？**
浏览器支持 Chrome、Microsoft Edge、Firefox、Safari、Opera、Internet Explorer；操作系统支持 Windows、macOS、iOS / iPadOS、Android、Linux、Chrome OS、HarmonyOS；渲染引擎可识别 Blink、WebKit、Gecko、Trident。

**Q3：「是否爬虫」都能查出哪些爬虫？**
内置 18 条规则，覆盖 Googlebot、Bingbot、Baiduspider、Yahoo Slurp、DuckDuckBot、YandexBot、Sogou 等搜索引擎爬虫，GPTBot、ClaudeBot、PerplexityBot、Bytespider 等 AI 爬虫，AhrefsBot、SemrushBot、MJ12bot 等 SEO 爬虫，以及 curl、wget、python-requests、Scrapy 等通用程序库（归为 Generic Bot / Library）。

**Q4：为什么有的字段显示「未知」？**
UA 字符串里没有携带对应信息时就会显示「未知」。例如桌面浏览器的 UA 通常不含设备型号，所以「设备厂商」「设备型号」显示未知是正常现象，并非解析失败。

**Q5：「复制全部解析结果」和「复制 JSON」有什么区别？**
前者是多行纯文本（`浏览器: Chrome 149.0.0.0` 这种格式），适合贴到聊天、邮件、文档里给人看；后者是格式化 JSON，附带 `isMobile`、`isBot` 等布尔字段，适合给程序读取或贴进技术工单，两者数值完全一致。