HTML一键打包EXE软件(HTML转EXE) 支持将Web前端项目转换为Windows平台下的独立可执行程序（EXE），适用于Windows 7及以上系统，无需额外配置系统环境, 软件包含多种内核, 包括IE内核, Chrome内核, 以及WebView2(永久免费), 适用于不同的使用场景.
本文主要对串口API进行介绍, 详细说明如何使用HTML一键打包EXE文件支持串口连接等功能。
什么是串口
首先简单介绍下串口, 首先串口（Serial Port）是一种非常经典的数据通信接口。它的核心特点是一位一位地顺序传输数据（串行传输），这与同时传输多位数据的并行接口不同。虽然速度通常不快，但串口以其简单、可靠、成本低的优势，在特定领域一直扮演着重要角色。
最常见的串口类型是异步串口（比如电脑上曾经的COM口）。它不需要专门的时钟线，通信双方依靠事先约定好的速度（波特率）和数据格式（如起始位、停止位）来同步数据。RS-232是早期最普及的标准，而RS-485则因其使用差分信号，抗干扰能力强、传输距离远（可达上千米），成为工业环境中的主力。
串口在我们日常生活中最常见的使用常见便是一些刷卡设备, 通常使用串口连接计算机进行通信, 可以方便的进行用户认证等场景。
HTML转EXE内部支持了串口API, 如果需要使用, 可以在打包时勾选上 启用API：
勾选后, 打包的网页即可以使用串口相关的API了, 下面是一个完整的串口通信的HTML的例子, 它可以进行串口连接, 发送数据:
<html>
<head> <script> const SerialPort = HTMLPackHelper.getSerialPort().SerialPort; let port; let isOpened; async function showPorts() { let ports = await SerialPort.list(); document.getElementById("textArea").value += ports.map(port => port.path + ":" + port.friendlyName).join("\n") + "\n"; } async function openPort() { const portName = document.getElementById("portName").value; port = new SerialPort({ path: portName, baudRate: 9600, autoOpen: false }); if (port.isOpened) { try { await port.close() } catch (err) { document.getElementById("textArea").value += '端口关闭失败！' + err.message + "\n"; return; } }
port.on('error', err => { document.getElementById("textArea").value += '发生错误: ' + err.message + "\n"; });
port.on('data', data => { document.getElementById("textArea").value += '收到数据: ' + data + "\n"; });
port.open(function (err) { if (err) { document.getElementById("textArea").value += '端口打开失败: ' + err.message + "\n"; return; } isOpened = true; document.getElementById("textArea").value += '打开端口成功' + "\n"; });
} async function sendData() { const data = document.getElementById("data").value; try { port.write(data + "\n"); document.getElementById("textArea").value += '发送数据成功\n'; } catch (err) { document.getElementById("textArea").value += '发送数据失败: ' + err.message+'\n'; } } </script></head>
<body> <button onclick="showPorts()">显示所有串口信息</button> <div> <textarea id="textArea" style="width: 800px;height: 600px;"></textarea> </div> <br> <button onclick="openPort()">连接串口</button> <label>串口名称</label> <input id="portName" type="text"></input> <button onclick="sendData()">发送数据</button> <input id="data" type="text"></input></body></html>
把上面的文件保存到一个单独的文件夹中, 然后用HTML一键打包EXE工具进行打包, 打包生成的EXE文件如下:
此时, 我们可以在打包生成的EXE中, 先点击显示所有串口信息, 即可列出当前系统中的所有串口名称, 此时我们在打包生成EXE的下方, 输入串口名称(例如COM4), 然后点击连接串口, 即可对窗口进行连接, 此时我们便可以发送数据了.
API详解
打包的时候勾选启用API, 即可在HTML页面的任意位置调用串口通信API，进行串口通信。示例代码如下：
const SerialPort = HTMLPackHelper.getSerialPort().SerialPort;
获得串口列表代码：
const ports = await SerialPort.list();console.log(ports.map(port => port.path + ":" + port.friendlyName).join("\n"));
上面的代码可以打印出类似如下的串口信息
COM1:Electronic Team Virtual Serial Port (COM1->COM2)COM2:Electronic Team Virtual Serial Port (COM2->COM1)
打开COM1串口，并添加监听事件，用于接收串口发到上位机的数据const port = new SerialPort({ path: "COM1", baudRate: 9600, autoOpen: false });
port.on('error', err => { console.log('发生错误: ' + err.message + "\n");});
port.on('data', data => { console.log('收到数据: ' + data + "\n");});
port.open(function (err) { if (err) { console.log('端口打开失败: ' + err.message + "\n");return; } console.log('打开端口成功' + "\n");});
向COM1串口发送数据
try { port.write("你好"+ "\n");}catch (err) { console.log('发送数据失败: ' + err.message+'\n');}
阅读原文：原文链接
该文章在 2025/6/24 10:48:34 编辑过
400 186 1886
