COMTool：跨平台串口网络调试助手

项目简介

COMTool 是一款用 Python 编写的跨平台串口 / 网络调试助手，可在 Windows、Linux、macOS 和树莓派上运行。它提供串口、TCP/UDP、SSH 等多种连接方式，并通过插件机制扩展功能，适合嵌入式开发、硬件调试和协议分析等场景。

主要功能

• 跨平台：Windows、Linux、macOS、Raspberry Pi，只要平台支持 Python 即可运行
• 界面稳定不卡顿，支持多语言界面和多字符编码（ASCII、GBK、UTF-8、UTF-16 等）
• 配置自动保存，退出时自动保存、下次启动自动加载
• 多种连接类型，并支持自行添加连接插件：
  • 串口：自动检测、记住上次选择、离线自动重连、波特率（任意值）/数据位/校验位/停止位/流控设置、手动控制 RTS 与 DTR
  • TCP/UDP：包含客户端与服务端模式
  • SSH 客户端
• 插件机制，内置插件：
  • dbg 调试插件：ASCII 与 HEX 收发、收发数据计数、清空接收区、自动换行、定时自动发送、发送历史、常用数据自定义并一键发送、CR LF 与 LF 支持、Ctrl+Enter 等快捷键、收发记录时间戳与日志保存、发送文件、终端颜色（如 \x1b[33;42mhello\x1b[0m）、转义字符
  • protocol 协议插件：自定义编码解码方式与快捷键
  • terminal 终端插件：基础终端交互
  • graph 图形插件：动态添加波形控件、实时折线图、自定义协议头、自定义按钮发送数据并支持快捷键

安装与使用

有两种安装方式：下载二进制文件直接运行，或作为 Python 包安装。

Windows：在 release 页面或 sourceforge 下载最新 .zip，解压后点击 comtool.exe 运行；也可通过 scoop 安装：

scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

macOS：在 release 页面下载并安装 dmg 包。若想打开多个窗口，可右键 dock 图标选择 New Window，或执行 open -n /Application/comtool.app。

Linux：官方只为 ubuntu 编译二进制，其他发行版建议用 pypi 或源码安装；Arch 及其衍生版可用 AUR：

# Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

为避免每次使用 sudo，把当前用户加入 dialout 组：

sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect

Python 包安装（适用于 Linux、需要使用插件或自行开发的用户）：

pip3 install comtool
comtool

国内可使用清华镜像加速：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool

也可从源码安装：

git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip install .

树莓派可先用包管理器安装依赖，再用 pip 安装其余包：

sudo apt install git python3-pyqt5 python3-numpy

注意事项

• 程序未由开发者签名，macOS 首次打开会提示警告，需要到「设置 -> 安全性与隐私 -> 通用」中点击 Open anyway 放行。
• Windows Defender 可能把下载的二进制误报为恶意软件，这由打包工具导致；源码与自动化打包脚本均公开，如有顾虑可从源码运行或自行打包（pip3 install pyinstaller 后执行 python pack.py）。
• 插件开发说明见仓库中的 docs/plugins.md。
• 许可证：LGPL-3.0。

---

本作品整理自 GitHub 开源项目 Neutree/COMTool，原作者 @Neutree，许可证 LGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。