Ubuntu 下 CuteCom 串口调试工具指南：安装、权限配置与数据记录

在嵌入式开发和硬件调试领域，串口通信是最基础也最常用的交互方式。无论是调试单片机、与物联网设备通信，还是查看工控设备的运行日志，串口工具都是工程师手中不可或缺的"利器"。

在 Linux 生态中，串口工具的选择不少------从经典的 Minicom 到强大的 Screen，各有千秋。而 CuteCom 以其直观的图形界面和简洁的操作逻辑，成为了许多开发者在 Ubuntu 桌面环境下的首选。本文将带你从零开始，全面掌握 CuteCom 的安装、权限配置与数据记录方法。

一、CuteCom 是什么？

CuteCom 是一款专为 Linux 系统设计的图形化串口终端工具，其核心定位是为嵌入式开发、物联网设备调试、工控设备等基于 UART/RS-232/RS-485 接口的硬件设备提供轻量、直观的交互环境。

与 Minicom 这类文本界面的串口工具相比，CuteCom 提供了更加友好的操作体验。它的主要特点包括：

简单易用的图形界面：无需记忆复杂的键盘快捷键
面向行的操作方式：按行发送数据，而不是逐字符
十六进制显示与发送：支持 Hex 格式的数据收发
文件传输支持：支持 XMODEM、YMODEM、ZMODEM 协议（需安装 lrzsz 包）
通信会话日志记录：可将收发数据保存到文件，便于后续分析

二、在 Ubuntu 22.04 上安装 CuteCom

2.1 通过 APT 安装（推荐）

这是最快捷、最稳定的安装方式。CuteCom 已被包含在 Ubuntu 的官方 universe 软件仓库中。

打开终端，执行以下命令：

bash 复制代码

# 更新软件包列表（可选）
sudo apt update

# 安装 CuteCom
sudo apt install cutecom

安装完成后，你可以通过以下两种方式启动 CuteCom：

在终端中输入 cutecom 并回车
在应用程序菜单中搜索 "CuteCom" 并点击图标

2.2 从源代码编译安装（可选）

如果你需要最新版本的功能，也可以从源代码编译安装。首先安装编译依赖：

bash 复制代码

sudo apt install build-essential qt5-default libqt5serialport5-dev cmake

然后从 GitLab 克隆源码并编译：

bash 复制代码

git clone https://gitlab.com/cutecom/cutecom.git
cd cutecom
mkdir build && cd build
cmake ..
make
sudo make install

注意：master 分支已迁移至 Qt6，如果你的系统是 Qt5，建议使用 rel/0.51.0 分支。对于绝大多数开发调试场景，APT 安装的版本功能已经足够。

三、串口权限配置（关键步骤）

在 Linux 系统中，串口设备文件（如 /dev/ttyUSB0、/dev/ttyS0）默认只有 root 用户和特定组成员才有读写权限。如果直接用普通用户打开 CuteCom，很可能会遇到 "Permission denied" 的错误提示。

3.1 将用户添加到 dialout 组（推荐）

在 Ubuntu/Debian 系统中，串口设备归属于 dialout 组。将当前用户加入该组即可获得串口访问权限：

bash 复制代码

sudo usermod -a -G dialout $USER

重要：执行此命令后，需要注销并重新登录（或重启系统）才能使组权限生效。

重新登录后，可以通过以下命令验证是否已成功加入 dialout 组：

bash 复制代码

groups $USER

如果输出中包含了 dialout，说明配置成功。

3.2 临时解决方案（不推荐）

如果只是临时使用，也可以用 sudo 以 root 权限启动 CuteCom：

bash 复制代码

sudo cutecom

不过这种方法并不推荐作为日常使用方式------以 root 权限运行图形应用存在一定的安全风险。

或者修改串口的权限：

bash 复制代码

sudo chmod 666 /dev/ttyTHS1

3.3 识别串口设备

在配置串口参数之前，需要先确认你要连接的串口设备名称。

方法一：查看 /dev 目录

bash 复制代码

ls /dev/ttyUSB*   # USB 转串口设备
ls /dev/ttyS*     # 原生串口设备

方法二：使用 dmesg 查看内核日志

bash 复制代码

dmesg | grep tty

插入 USB 转串口适配器后，通常会出现 /dev/ttyUSB0 这样的设备文件。

四、CuteCom 的基本使用

4.1 界面概览

启动 CuteCom 后，主窗口主要分为以下几个区域：

串口配置区：位于界面顶部，用于设置设备、波特率、数据位等参数
接收窗口：实时显示从串口接收到的数据
发送窗口：用于输入要发送的数据
菜单栏：提供保存日志、清除屏幕等高级功能

4.2 配置串口参数

在串口配置区域，按以下步骤设置参数：

参数	说明	常见值
Device	串口设备路径	`/dev/ttyUSB0`、`/dev/ttyS0`
Baud rate	波特率	`115200`、`9600`
Data bits	数据位	`8`
Stop bits	停止位	`1`
Parity	校验位	`None`
Flow Control	流控制	`None`

注意：CuteCom 的设备下拉菜单中默认只显示 ttyS0--ttyS3，如果使用 USB 转串口设备（ttyUSB0），需要手动输入设备名称。

完成设置后，点击 "Open Device" 按钮打开串口。

五、记录串口数据到文件

CuteCom 提供了便捷的日志记录功能，可以将串口通信数据保存到文件中，便于后续分析和问题排查。

5.1 通过菜单保存日志

操作步骤如下：

点击菜单栏的 "文件"（File）
在下拉菜单中选择 "保存"（Save）
在弹出的文件保存对话框中，选择保存位置并输入文件名
点击 "保存" 按钮

5.2 通过界面按钮保存

部分版本的 CuteCom 在界面中提供了 "Log" 按钮，点击即可将通信数据保存到文件。

5.3 关于保存路径的说明

CuteCom 保存文件时，默认路径是启动 CuteCom 的终端窗口的当前工作目录 ，而不是你的桌面或家目录。如果你在终端中先执行了 cd /tmp 再启动 CuteCom，文件就会保存在 /tmp 目录下。

为了避免找不到文件，建议在保存对话框中选择一个明确的目录（如桌面或文档文件夹），或者直接输入绝对路径（如 /home/你的用户名/Documents/serial_log.txt）。

日志保存路径也可以在 CuteCom 的设置中指定，并支持按时间戳格式化文件名，方便管理和索引日志文件。

5.4 日志记录的使用场景

调试嵌入式设备：记录设备启动日志，分析异常行为
数据采集：长时间记录传感器数据，用于后续分析
问题复现：保存通信会话，便于与团队分享和协作排查

六、常见问题与解决

问题	可能原因	解决方法
串口无法打开	权限不足	将用户加入 `dialout` 组并重新登录
设备列表中找不到 ttyUSB0	CuteCom 默认只显示 ttyS*	手动输入 `/dev/ttyUSB0`
接收数据乱码	波特率/数据位/校验位不匹配	确认两端参数设置一致
无法保存日志文件	保存路径无写入权限	选择有写入权限的目录，或使用绝对路径
设备已被占用	其他程序正在使用该串口	关闭其他串口程序，或者用 `sudo fuser /dev/ttyUSB0` 查看占用进程

七、总结

CuteCom 是一款功能强大且易于使用的图形化串口调试工具。通过 APT 可以一键安装，将用户加入 dialout 组即可解决权限问题，而日志记录功能则让数据分析和问题排查变得轻松高效。

无论是嵌入式开发、物联网设备调试，还是工控系统的日常维护，CuteCom 都能成为你得力的助手。希望本文能帮助你快速上手 CuteCom，在串口调试的道路上少走一些弯路。
老徐，2026/07/15，晴，入伏