测试工程师的 BLE 抓包实战：从开关到 Wireshark 逐帧解读（红米/小米避坑版）

| 关键词：BLE、蓝牙抓包、HCI snoop、Wireshark、GATT、双模蓝牙、移动端测试排障

一、为什么测试工程师要会 BLE 抓包

做移动端测试，尤其是穿戴类（智能手表、耳机、手环、音箱）产品，App 和设备之间的通信几乎都走 BLE（低功耗蓝牙）。日常排障最常遇到三类问题：

蓝牙配对后反复断连
OTA 升级中断或校验失败
设备数据（电量、心率、步数）在 App 上不刷新

这类问题最忌讳"靠猜"------到底是 App 端（Host） 没发指令，还是 固件端（Controller/芯片） 没回事件？两边团队经常互相甩锅。而 蓝牙抓包（Sniffer） 就是那把"在通信链路上装个监听器"的刀，谁在说话、谁没回，一眼看穿。

本文以一个测试工程师的实操视角，带你从零跑通 Android（红米/小米）抓取蓝牙 HCI 包 → Wireshark 解读 GATT 的完整链路，并把过程中两个只有踩过才知道的坑讲透。

二、先搞清几个概念

动手前先对齐术语，不然后面看包会一头雾水。

概念	一句话解释
BLE	Bluetooth Low Energy，低功耗蓝牙无线电协议。它不是"智能穿戴"的别名，而是一种通信方式
经典蓝牙（BR/EDR）	传大数据用：A2DP 传音频、HFP 走通话、AVRCP 走播放控制
GATT	BLE 的应用层协议：设备把数据组织成 Service / Characteristic，App 通过读/写/通知和它交互（电量、心率都在这）
HCI	Host Controller Interface，手机系统（Host）和蓝牙芯片（Controller）之间的接口------抓包就抓这道"门"上的双向流量
双模（Dual-mode）	同一块蓝牙芯片同时跑经典蓝牙栈 + BLE 栈，既能传音频又能传小数据
私有 UUID	厂商自定义的 Service/Characteristic（长得像一长串 `66666666-...`），心率同步、OTA 这些"独门协议"都藏在这里，公开规范里查不到
CCCD（0x2902）	Client Characteristic Configuration Descriptor，就是"通知开关"。打开后设备主动把数据推给 App，所以电量/步数能自动刷新

记忆点：你之前用 nRF Connect 连设备看到的"服务树"，底层就是 GATT；那一长串看不懂的 UUID，就是厂商的私有协议。

三、准备清单

项目	说明
一台安卓手机	本文用红米 Note 14 Pro（HyperOS / Android 16）。小米/红米有专属坑，详见第四节
一台 BLE 外设	本文用漫步者 EDIFIER BLE（音箱的 BLE 控制端）。任意 BLE 设备都行，甚至另一台手机开广播
电脑	Mac / Windows 均可，装 Wireshark （https://www.wireshark.org）
ADB	`brew install android-platform-tools`（Mac），用于强制生成报告、修复开关
调试 App	nRF Connect （Google Play）或其国产平替 BLE调试宝（小米应用商店可装，免 Google 框架）

没有 Google Play 也不用慌：国产商店搜 "BLE调试宝" 即可，功能和 nRF Connect 基本一致------扫描、连接、看服务树、读特征值、订阅通知全都有。

四、抓包五步（含红米专属大坑）

第 1 步：开启 HCI 抓包开关 ------ ⚠️ 红米/小米有"假启用"坑

进入 开发者选项 → 搜索"HCI" → 打开「启用蓝牙 HCI 信息收集日志」。

坑来了（重点） ：在小米/红米（HyperOS/MIUI）上，这个开关经常显示"已启用"，但底层根本没生效。表现就是：你怎么抓都是空包。

验证到底生没生效：

bash 复制代码

adb shell settings get global bluetooth_hci_log_enbale
# 注意 AOSP 官方拼写就是 enbale（少了个 b），别怀疑自己
# 返回 null = 没写进去，开关是假的

adb shell dumpsys bluetooth_manager | grep snoop
# 看这一行：
#   sSnoopLogSettingAtEnable = DISABLED   ← 假启用，抓出来只有 16 字节空文件

修复（已验证有效）：用 ADB 把值强行钉进去，再重启蓝牙让它重读配置：

bash 复制代码

adb shell settings put global bluetooth_hci_log_enbale 1
adb shell svc bluetooth disable
sleep 3
adb shell svc bluetooth enable
sleep 5
adb shell dumpsys bluetooth_manager | grep snoop
# 应变为：sSnoopLogSettingAtEnable = FULL   ← 这次真生效了

第 2 步：制造流量（最关键，也最容易被忽略）

我踩过的最大一个坑 ：以为"连上蓝牙就会产生数据"。实际上，只连接 = 一次短暂握手后就没动静了，抓包是空的。必须主动制造流量。

在手机上做这些操作之一（让空气里有真实数据跑）：

打开 BLE调试宝 / nRF Connect → 连接设备 → 点特征值旁边的 ↓ 读几个值（Device Name、Appearance、Battery）
或者连蓝牙耳机放首歌（走经典蓝牙栈）

保持操作 20~30 秒。

第 3 步：取包------用 ADB 生成 bugreport（最稳）

手机上点"开发者选项 → 生成错误报告"在小米机上经常无反应/无通知/生成空包。直接用 ADB 最稳：

bash 复制代码

adb bugreport ~/Desktop/br.zip

⚠️ 第二个坑 ：这份报告有 35MB 左右 ，默认命令超时（约 120s）会被系统杀掉，报 exit 137。务必把超时拉到 300000ms（在终端工具里设置，或后台运行等待）。

第 4 步：解包，取出真正的抓包文件

解压 br.zip，找这个路径：

复制代码

FS/data/misc/bluetooth/logs/btsnoop_hci.log

注意区分两个极易搞混的文件：

btsnoop_hci.log：完整抓包，我们要的就是它
btsnooz_hci.log ：系统塞进去的"最近 5 分钟压缩尾巴"，常常只有 16 字节（空）

用文件大小自检 ：btsnoop_hci.log 是 0 KB / 几 KB = 没抓到；几百 KB 以上 = 有货。

第 5 步：Wireshark 打开并分析

把 btsnoop_hci.log 拖进 Wireshark 即可。没有图形界面也行，tshark 命令行就在 Wireshark 安装包里（Mac 路径：/Applications/Wireshark.app/Contents/MacOS/tshark）。

常用过滤器（Apply a display filter 栏输入回车）：

过滤器	看什么
`btatt`	GATT 读写（电量、设备名这类 BLE 通信）
`btavdtp` / `btavrcp` / `bthfp`	音频流 / 播放控制 / 通话（经典蓝牙）
`bthci_evt`	找 `Connection Complete`，看设备什么时候连上
`btl2cap`	更底层的通道

看任何一行的三步读法：

看 Source → Destination ：谁在说话（host → controller 是系统下命令，controller → host 是芯片回事件）
看 Protocol ：HCI_CMD 命令、HCI_EVT 事件、ATT 才是真正的数据
看 Info ：Wireshark 已经翻译成人话，比如 Sent Read Request、Rcvd Read Response

五、实战解读：一次真实的 GATT 会话

我连的是 EDIFIER BLE （漫步者音箱的 BLE 控制端）。这份抓包：528 KB / 10392 帧 / 其中 50 帧是 ATT（GATT）。

前半段：App 连上后的"自动服务发现"

你刚连上设备、BLE调试宝里出现那棵"服务树"，底层就是这些包：

复制代码

Read By Group Type Request (Primary Service)
  → Response: GAP, GATT, 两个 Unknown（私有 UUID）
Read By Type Request (Characteristic)
  → Response: Device Name, Appearance, Service Changed
Find Information Request
  → Response: 命中 0x2902（CCCD，通知开关）

一句话：你在 App 上看到的服务树，是 App 通过这一连串 GATT 请求"问"出来的。

后半段：我手动点的那两下读（协议层真身）

我在 App 里点 Device Name、Appearance 的 ↓，抓包里精确对应：

帧号	方向	协议动作	结果
9805	手机 → 设备	`Read Request, Handle 0x0003 (Device Name)`	---
9807	设备 → 手机	`Read Response`	Device Name: EDIFIER BLE
9890	手机 → 设备	`Read Request, Handle 0x0005 (Appearance)`	---
9892	设备 → 手机	`Read Response`	Appearance: 0x0000 (Generic)

这就是"在 App 上点一下 ↓"在协议层的逐字节对应------发一个 Read Request，设备回一个 Read Response，值原样带回。和你之前在界面上看到的内容完全对得上。

六、双模实证：同一个设备，两条栈并存

这次抓包最妙的彩蛋，是顺便验证了"双模"不是空概念。

漫步者这台设备：经典蓝牙端叫 EDIFIER （传音频），BLE 端叫 EDIFIER BLE （传控制指令）。在我同一台红米、同一份 btsnoop 文件里：

之前连耳机播歌 → 抓到 AVDTP / A2DP（音频）、HFP（通话）、AVRCP（控制）------经典蓝牙栈
这次连 EDIFIER BLE 读特征值 → 抓到 ATT / GATT------BLE 栈

同一块芯片，两套协议栈同时跑，抓包里清清楚楚并存。 以后谁再跟你说"双模蓝牙"，你直接甩这份抓包。

七、回到测试：怎么用嗅探排障

把上面这套落到日常排障，核心逻辑就一句话：

HCI 是 App 和固件之间的"门"。在门上听一声，就知道锅在哪边。

门这边（Host/App）命令明明发了 ，门那边（Controller/固件）没回事件 → 固件端问题
门这边压根没发出命令 → App 端 / 协议栈问题

典型场景：配对断连、OTA 中断、数据不刷新，先用抓包确认"命令到没到、事件回没回"，再决定去找 App 开发还是固件开发，沟通效率直接翻倍。

面试能讲通的"嗅探排障"三板斧：

先确认开关真生效 ------我踩过 MIUI 显示"已启用"实际 DISABLED 的坑，必须 adb 把值钉进去再重启蓝牙
必须复现真实场景制造流量------只连不操作，抓到的就是空包（这是我自己悟出来的，比概念值钱）
在 HCI 这道门上听------区分 Host 命令 vs Controller 事件，判断问题在 App 还是固件

八、避坑清单（建议收藏）

✅ 小米/红米开 HCI 开关后，务必 dumpsys bluetooth_manager | grep snoop 验证是 FULL 不是 DISABLED
✅ 修复命令：settings put global bluetooth_hci_log_enbale 1 + 重启蓝牙
✅ 连上 ≠ 有数据，必须主动读特征值 / 播音频制造流量
✅ 取包用 adb bugreport，超时设 300000ms，别用手机上点"生成报告"（小米机常空）
✅ 要的是 btsnoop_hci.log，不是 btsnooz_hci.log（后者 16 字节空尾巴）
✅ 看 GATT 用过滤器 btatt；看经典蓝牙音频用 btavdtp / btavrcp / bthfp
✅ 文件大小自检：几百 KB = 成功，几 KB = 重来

写在最后

这里写自定义目录标题

- [一、为什么测试工程师要会 BLE 抓包](#一、为什么测试工程师要会 BLE 抓包)
- 二、先搞清几个概念
- 三、准备清单
- 四、抓包五步（含红米专属大坑）
- - [第 1 步：开启 HCI 抓包开关 ------ ⚠️ 红米/小米有"假启用"坑](#第 1 步：开启 HCI 抓包开关 —— ⚠️ 红米/小米有"假启用"坑)
  - [第 2 步：制造流量（最关键，也最容易被忽略）](#第 2 步：制造流量（最关键，也最容易被忽略）)
  - [第 3 步：取包------用 ADB 生成 bugreport（最稳）](#第 3 步：取包——用 ADB 生成 bugreport（最稳）)
  - [第 4 步：解包，取出真正的抓包文件](#第 4 步：解包，取出真正的抓包文件)
  - [第 5 步：Wireshark 打开并分析](#第 5 步：Wireshark 打开并分析)
- [五、实战解读：一次真实的 GATT 会话](#五、实战解读：一次真实的 GATT 会话)
- - [前半段：App 连上后的"自动服务发现"](#前半段：App 连上后的"自动服务发现")
  - 后半段：我手动点的那两下读（协议层真身）
- 六、双模实证：同一个设备，两条栈并存
- 七、回到测试：怎么用嗅探排障
- 八、避坑清单（建议收藏）
- 写在最后
欢迎使用Markdown编辑器

欢迎使用Markdown编辑器

你好！这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

全新的界面设计 ，将会带来全新的写作体验；
在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
全新的 KaTeX数学公式 语法；
增加了支持甘特图的mermaid语法^{[1](#甘特图的mermaid语法1)} 功能；
增加了 多屏幕编辑 Markdown文章功能；
增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z

重做：Ctrl/Command + Y

加粗：Ctrl/Command + B

斜体：Ctrl/Command + I

标题：Ctrl/Command + Shift + H

无序列表：Ctrl/Command + Shift + U

有序列表：Ctrl/Command + Shift + O

检查列表：Ctrl/Command + Shift + C

插入代码：Ctrl/Command + Shift + K

插入链接：Ctrl/Command + Shift + L

插入图片：Ctrl/Command + Shift + G

查找：Ctrl/Command + F

替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。

输入2次#，并按下space后，将生成2级标题。

以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

javascript 复制代码

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

项目
- 项目
  - 项目

项目1
项目2
项目3

计划任务
完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中

使用:----------居左

使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：

原始符号	转换后	说明
`"引号"`	"引号"	直引号变弯引号
`'单引号'`	'单引号'	直单引号变弯单引号
`--`	--	两个连字符变短破折号
`---`	---	三个连字符变长破折号
`...`	...	三个点变省略号

创建一个自定义列表

:
Text-to- conversion tool
: John
: Luke

如何创建一个注脚

一个具有注脚的文本。^[2](#2)

注释也是必不可少的

Markdown将文本转换为。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

#mermaid-svg-mYyG9U0xlBQdxTuy{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-mYyG9U0xlBQdxTuy .error-icon{fill:#552222;}#mermaid-svg-mYyG9U0xlBQdxTuy .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-mYyG9U0xlBQdxTuy .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-mYyG9U0xlBQdxTuy .marker{fill:#333333;stroke:#333333;}#mermaid-svg-mYyG9U0xlBQdxTuy .marker.cross{stroke:#333333;}#mermaid-svg-mYyG9U0xlBQdxTuy svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-mYyG9U0xlBQdxTuy p{margin:0;}#mermaid-svg-mYyG9U0xlBQdxTuy .mermaid-main-font{font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-mYyG9U0xlBQdxTuy .exclude-range{fill:#eeeeee;}#mermaid-svg-mYyG9U0xlBQdxTuy .section{stroke:none;opacity:0.2;}#mermaid-svg-mYyG9U0xlBQdxTuy .section0{fill:rgba(102, 102, 255, 0.49);}#mermaid-svg-mYyG9U0xlBQdxTuy .section2{fill:#fff400;}#mermaid-svg-mYyG9U0xlBQdxTuy .section1,#mermaid-svg-mYyG9U0xlBQdxTuy .section3{fill:white;opacity:0.2;}#mermaid-svg-mYyG9U0xlBQdxTuy .sectionTitle0{fill:#333;}#mermaid-svg-mYyG9U0xlBQdxTuy .sectionTitle1{fill:#333;}#mermaid-svg-mYyG9U0xlBQdxTuy .sectionTitle2{fill:#333;}#mermaid-svg-mYyG9U0xlBQdxTuy .sectionTitle3{fill:#333;}#mermaid-svg-mYyG9U0xlBQdxTuy .sectionTitle{text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-mYyG9U0xlBQdxTuy .grid .tick{stroke:lightgrey;opacity:0.8;shape-rendering:crispEdges;}#mermaid-svg-mYyG9U0xlBQdxTuy .grid .tick text{font-family:"trebuchet ms",verdana,arial,sans-serif;fill:#333;}#mermaid-svg-mYyG9U0xlBQdxTuy .grid path{stroke-width:0;}#mermaid-svg-mYyG9U0xlBQdxTuy .today{fill:none;stroke:red;stroke-width:2px;}#mermaid-svg-mYyG9U0xlBQdxTuy .task{stroke-width:2;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskText{text-anchor:middle;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutsideRight{fill:black;text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutsideLeft{fill:black;text-anchor:end;}#mermaid-svg-mYyG9U0xlBQdxTuy .task.clickable{cursor:pointer;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskText.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutsideLeft.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutsideRight.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskText0,#mermaid-svg-mYyG9U0xlBQdxTuy .taskText1,#mermaid-svg-mYyG9U0xlBQdxTuy .taskText2,#mermaid-svg-mYyG9U0xlBQdxTuy .taskText3{fill:white;}#mermaid-svg-mYyG9U0xlBQdxTuy .task0,#mermaid-svg-mYyG9U0xlBQdxTuy .task1,#mermaid-svg-mYyG9U0xlBQdxTuy .task2,#mermaid-svg-mYyG9U0xlBQdxTuy .task3{fill:#8a90dd;stroke:#534fbc;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutside0,#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutside2{fill:black;}#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutside1,#mermaid-svg-mYyG9U0xlBQdxTuy .taskTextOutside3{fill:black;}#mermaid-svg-mYyG9U0xlBQdxTuy .active0,#mermaid-svg-mYyG9U0xlBQdxTuy .active1,#mermaid-svg-mYyG9U0xlBQdxTuy .active2,#mermaid-svg-mYyG9U0xlBQdxTuy .active3{fill:#bfc7ff;stroke:#534fbc;}#mermaid-svg-mYyG9U0xlBQdxTuy .activeText0,#mermaid-svg-mYyG9U0xlBQdxTuy .activeText1,#mermaid-svg-mYyG9U0xlBQdxTuy .activeText2,#mermaid-svg-mYyG9U0xlBQdxTuy .activeText3{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .done0,#mermaid-svg-mYyG9U0xlBQdxTuy .done1,#mermaid-svg-mYyG9U0xlBQdxTuy .done2,#mermaid-svg-mYyG9U0xlBQdxTuy .done3{stroke:grey;fill:lightgrey;stroke-width:2;}#mermaid-svg-mYyG9U0xlBQdxTuy .doneText0,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText1,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText2,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText3{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .doneText0.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText0.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText1.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText1.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText2.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText2.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText3.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .crit0,#mermaid-svg-mYyG9U0xlBQdxTuy .crit1,#mermaid-svg-mYyG9U0xlBQdxTuy .crit2,#mermaid-svg-mYyG9U0xlBQdxTuy .crit3{stroke:#ff8888;fill:red;stroke-width:2;}#mermaid-svg-mYyG9U0xlBQdxTuy .activeCrit0,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCrit1,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCrit2,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCrit3{stroke:#ff8888;fill:#bfc7ff;stroke-width:2;}#mermaid-svg-mYyG9U0xlBQdxTuy .doneCrit0,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCrit1,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCrit2,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCrit3{stroke:#ff8888;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges;}#mermaid-svg-mYyG9U0xlBQdxTuy .milestone{transform:rotate(45deg) scale(0.8,0.8);}#mermaid-svg-mYyG9U0xlBQdxTuy .milestoneText{font-style:italic;}#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText0,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText1,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText2,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText3{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText0.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText0.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText1.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText1.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText2.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText2.taskTextOutsideRight,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText3.taskTextOutsideLeft,#mermaid-svg-mYyG9U0xlBQdxTuy .doneCritText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .vert{stroke:navy;}#mermaid-svg-mYyG9U0xlBQdxTuy .vertText{font-size:15px;text-anchor:middle;fill:navy!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .activeCritText0,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCritText1,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCritText2,#mermaid-svg-mYyG9U0xlBQdxTuy .activeCritText3{fill:black!important;}#mermaid-svg-mYyG9U0xlBQdxTuy .titleText{text-anchor:middle;font-size:18px;fill:#333;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-mYyG9U0xlBQdxTuy :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成进行中计划一计划二现有任务 Adding GANTT diagram functionality to mermaid

关于 甘特图 语法，参考这儿,

UML图表

可以使用UML图表进行渲染，例如下面产生的一个序列图：
王五李四张三王五李四张三 #mermaid-svg-Juiym77Cw3VXtxfz{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Juiym77Cw3VXtxfz .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Juiym77Cw3VXtxfz .error-icon{fill:#552222;}#mermaid-svg-Juiym77Cw3VXtxfz .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Juiym77Cw3VXtxfz .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Juiym77Cw3VXtxfz .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Juiym77Cw3VXtxfz .marker.cross{stroke:#333333;}#mermaid-svg-Juiym77Cw3VXtxfz svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Juiym77Cw3VXtxfz p{margin:0;}#mermaid-svg-Juiym77Cw3VXtxfz .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-Juiym77Cw3VXtxfz text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-Juiym77Cw3VXtxfz .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-Juiym77Cw3VXtxfz .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-Juiym77Cw3VXtxfz .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-Juiym77Cw3VXtxfz .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-Juiym77Cw3VXtxfz #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-Juiym77Cw3VXtxfz .sequenceNumber{fill:white;}#mermaid-svg-Juiym77Cw3VXtxfz #sequencenumber{fill:#333;}#mermaid-svg-Juiym77Cw3VXtxfz #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-Juiym77Cw3VXtxfz .messageText{fill:#333;stroke:none;}#mermaid-svg-Juiym77Cw3VXtxfz .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-Juiym77Cw3VXtxfz .labelText,#mermaid-svg-Juiym77Cw3VXtxfz .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-Juiym77Cw3VXtxfz .loopText,#mermaid-svg-Juiym77Cw3VXtxfz .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-Juiym77Cw3VXtxfz .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-Juiym77Cw3VXtxfz .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-Juiym77Cw3VXtxfz .noteText,#mermaid-svg-Juiym77Cw3VXtxfz .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-Juiym77Cw3VXtxfz .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-Juiym77Cw3VXtxfz .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-Juiym77Cw3VXtxfz .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-Juiym77Cw3VXtxfz .actorPopupMenu{position:absolute;}#mermaid-svg-Juiym77Cw3VXtxfz .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-Juiym77Cw3VXtxfz .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-Juiym77Cw3VXtxfz .actor-man circle,#mermaid-svg-Juiym77Cw3VXtxfz line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-Juiym77Cw3VXtxfz :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 李四想了很长时间, 文字太长了不适合放在一行. 你好！李四, 最近怎么样? 你最近怎么样，王五？我很好，谢谢! 我很好，谢谢! 打量着王五... 很好... 王五, 你怎么样?

关于 UML图表 语法，参考这儿,

流程图

#mermaid-svg-MhRLdnUGWCMdWUe9{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-MhRLdnUGWCMdWUe9 .error-icon{fill:#552222;}#mermaid-svg-MhRLdnUGWCMdWUe9 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-MhRLdnUGWCMdWUe9 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .marker.cross{stroke:#333333;}#mermaid-svg-MhRLdnUGWCMdWUe9 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-MhRLdnUGWCMdWUe9 p{margin:0;}#mermaid-svg-MhRLdnUGWCMdWUe9 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster-label text{fill:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster-label span{color:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster-label span p{background-color:transparent;}#mermaid-svg-MhRLdnUGWCMdWUe9 .label text,#mermaid-svg-MhRLdnUGWCMdWUe9 span{fill:#333;color:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .node rect,#mermaid-svg-MhRLdnUGWCMdWUe9 .node circle,#mermaid-svg-MhRLdnUGWCMdWUe9 .node ellipse,#mermaid-svg-MhRLdnUGWCMdWUe9 .node polygon,#mermaid-svg-MhRLdnUGWCMdWUe9 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .rough-node .label text,#mermaid-svg-MhRLdnUGWCMdWUe9 .node .label text,#mermaid-svg-MhRLdnUGWCMdWUe9 .image-shape .label,#mermaid-svg-MhRLdnUGWCMdWUe9 .icon-shape .label{text-anchor:middle;}#mermaid-svg-MhRLdnUGWCMdWUe9 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .rough-node .label,#mermaid-svg-MhRLdnUGWCMdWUe9 .node .label,#mermaid-svg-MhRLdnUGWCMdWUe9 .image-shape .label,#mermaid-svg-MhRLdnUGWCMdWUe9 .icon-shape .label{text-align:center;}#mermaid-svg-MhRLdnUGWCMdWUe9 .node.clickable{cursor:pointer;}#mermaid-svg-MhRLdnUGWCMdWUe9 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .arrowheadPath{fill:#333333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-MhRLdnUGWCMdWUe9 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-MhRLdnUGWCMdWUe9 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-MhRLdnUGWCMdWUe9 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster text{fill:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 .cluster span{color:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-MhRLdnUGWCMdWUe9 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-MhRLdnUGWCMdWUe9 rect.text{fill:none;stroke-width:0;}#mermaid-svg-MhRLdnUGWCMdWUe9 .icon-shape,#mermaid-svg-MhRLdnUGWCMdWUe9 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-MhRLdnUGWCMdWUe9 .icon-shape p,#mermaid-svg-MhRLdnUGWCMdWUe9 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-MhRLdnUGWCMdWUe9 .icon-shape .label rect,#mermaid-svg-MhRLdnUGWCMdWUe9 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-MhRLdnUGWCMdWUe9 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-MhRLdnUGWCMdWUe9 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-MhRLdnUGWCMdWUe9 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 链接
长方形
圆
圆角长方形
菱形

关于 Mermaid 语法，参考这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法：
Created with Raphaël 2.3.0 开始我的操作确认？结束 yes no

关于 Flowchart流程图 语法，参考这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，

继续你的创作。

mermaid语法说明 ↩︎
注脚的解释 ↩︎

*[HTML]: 超文本标记语言