串口打开失败：permission denied

kaixin_learn_qt_ing · 2026-10-12 08:51:17 发布

“Permission denied”在串口场景下，通常意味着权限不足或端口被占用。具体解决方法取决于你的操作系统。

Linux 系统默认只允许特定用户组访问串口设备，这是最常见的原因。

将当前用户加入串口组（推荐）
最常见的串口组是 dialout（Debian/Ubuntu）

# 加入 dialout 组（Ubuntu/Debian 等）
sudo usermod -aG dialout $USER

关键一步：执行后必须注销并重新登录（或重启电脑），用户组变更才会生效

把你当前的用户账号，添加到 dialout 这个用户组里，从而获得访问串口设备的权限。

拆开来看每个部分的含义：

部分	含义
`sudo`	以管理员（root）权限执行后面的命令。修改用户组需要管理员权限。
`usermod`	user modify 的缩写，是 Linux 中用来修改用户账号属性的命令。
`-aG`	两个选项的组合：`-a` 表示"追加"（append），`-G` 表示"指定附加组"。合起来就是追加到某个附加组，而不是替换掉原来的组。
`dialout`	目标用户组的名字。在 Debian/Ubuntu 等系统里，这个组拥有串口设备（如 `/dev/ttyUSB0`）的读写权限。
`$USER`	一个环境变量，代表你当前登录的用户名。比如你登录的用户叫 `alice`，它就等价于 `alice`。