Gulp + PostHTML 是低功耗蓝牙项目的首选组合，因其流式处理、内存占用低（<8MB）、构建耗时稳定（10–30ms），不抢Event Loop资源，避免拖慢navigator.bluetooth事件响应；而Webpack启动即占300MB+内存，易引发GC干扰BLE通信。
选错工具会导致蓝牙数据在打包阶段就丢帧、延迟飙升，甚至因内存溢出中断连接。核心原则是：HTML 打包工具本身不能成为 BLE 通信链路的瓶颈——它得轻、快、不抢资源。
为什么 Gulp + PostHTML 是低功耗蓝牙项目的首选组合
BLE 设备（如传感器、手环）通常只发小包（20–50 字节），但要求高频、低延迟上报；HTML 工程化若用 Webpack，光启动构建就占 300MB+ 内存、触发 Node.js GC 频繁，会间接拖慢主线程对 navigator.bluetooth 事件的响应。
-
Gulp是流式处理，不加载 AST、不解析模块依赖，单次 HTML 注入/路径替换耗时稳定在 10–30ms -
PostHTML直接操作字符串或简易 DOM 树，无虚拟 DOM 开销，posthtml-include和posthtml-modules插件加起来仅 120KB，内存驻留低于 8MB - 整个构建过程不依赖
webpack-dev-server这类常驻服务，避免与BluetoothRemoteGATTServer共争 Event Loop
必须禁用的 Gulp 插件和配置项
哪怕只多一个插件，都可能让老旧工控机或树莓派 Zero W 在打包时卡住 BLE 连接。以下配置在 gulpfile.js 中必须显式关闭：
- 禁用
gulp-watch：它会持续监听文件系统，触发inotify事件，在低配设备上易与蓝牙 HCI 层争抢内核中断 - 移除所有
gulp-sourcemaps：source map 生成需额外解析原始代码行号，增加 CPU 峰值负载，而 BLE 调试靠的是chrome://bluetooth-internals，不是断点 - 不要用
gulp-htmlmin默认配置：其collapseWhitespace: true会抹掉注释，而你很可能用<!-- @ble:device-id -->这类标记做设备绑定，应改用removeComments: false
PostHTML 插件链顺序决定 BLE 数据注入成败
你写的 <!-- @include "sensor-template.html" --> 如果被 posthtml-modules 先处理，那模板里带的 data-ble-service="0000180f-0000-1000-8000-00805f9b34fb" 就会被当成普通属性忽略——因为 modules 插件只认 <link> 和 <script> 标签。
立即学习“前端免费学习笔记（深入）”；
- 正确顺序：
posthtml-include→posthtml-expressions→posthtml-modules - 必须把 BLE 设备参数写成表达式，例如：
<div data-ble-char="{{ ble.char.uuid }}"></div>，再由posthtml-expressions渲染 - 如果用
posthtml-assets处理图片，确保publicPath设为'./'：BLE 打印模版或 OTA 页面常离线部署，绝对路径会导致资源 404，进而阻塞fetch()后续的 GATT 特征读取
真正容易被忽略的硬件适配点
不是所有“轻量”工具都真适配 BLE 场景。比如 KindEditor 嵌入版虽只有 15MB，但它默认启用 iframe 沙箱并拦截 postMessage，当你在编辑器里调试 navigator.bluetooth.requestDevice() 时，弹窗根本出不来——因为 Chromium 把它当成了跨域 iframe 的非用户激活上下文。
同理，Notepad++ 的 HTML 格式化插件（XML Tools）会重写缩进，把 <script>const device = await navigator.bluetooth.requestDevice(...)</script> 拆成多行，而某些 BLE 固件 OTA 升级脚本只认单行 JS —— 看似无关的格式化，实则导致固件烧录失败。
