sysfs是树莓派最轻量、兼容性最好的GPIO控制方式，官方系统默认启用，无需额外驱动或root权限（用户需在gpio组），但需注意BCM编号、direction设置、value写入前lseek重置偏移等关键细节。
用 sysfs 接口写 /sys/class/gpio/ 是最轻量、兼容性最好的方式
树莓派官方 Linux 系统（Raspberry Pi OS）默认启用 sysfs GPIO 接口，无需额外驱动或 root 权限（只要用户在 gpio 用户组里）。它不依赖第三方库，也不需要编译内核模块，适合快速验证和轻量控制。
常见错误是直接用 open() 写 /sys/class/gpio/export 但没检查返回值，导致后续操作失败却无提示；或者导出后忘记设置 direction 就直接写 value，结果写入无效。
- 先确认当前用户在
gpio组：运行groups，若无gpio，用sudo usermod -aG gpio $USER添加，然后重新登录 - GPIO 编号用“BCM 编号”，不是物理引脚号。比如物理引脚 12 对应 BCM 18，要导出的是
18，不是12 - 导出后必须写
out到direction文件，否则value写入会被忽略（不会报错，但电平不变） - 写
value只接受字符0或1（不能是整数 0/1，也不能是字符串"low"）
write() 写 value 前必须 lseek(fd, 0, SEEK_SET)
Linux sysfs 文件是伪文件，write() 不自动重置文件偏移。如果之前读过 value（比如查状态），再直接 write() 会失败或写到错误位置——现象是写入后电平没变，write() 返回 0 或 -1。
正确做法是每次写 value 前都先 lseek(fd, 0, SEEK_SET)，确保从开头写入单个字符。
立即学习“C++免费学习笔记（深入）”；
- 示例片段：
int fd = open("/sys/class/gpio/gpio18/value", O_WRONLY); lseek(fd, 0, SEEK_SET); // 关键！ write(fd, "1", 1); // 高电平 lseek(fd, 0, SEEK_SET); // 再次写前重置 write(fd, "0", 1); // 低电平 close(fd); - 不要用
fprintf()或std::ofstream，它们内部缓冲行为不可控，容易出错 - 写完不必
fsync()，sysfs不走磁盘缓存
避免用 libgpiod 做简单输出（除非你明确需要线程安全或事件监听）
libgpiod 是现代 Linux 推荐的 GPIO 用户空间接口，但它设计目标是多进程协作、中断监听和芯片级抽象。对单纯“设高低电平”这种场景，它反而更重、更易出错。
典型问题包括：初始化 gpiod_chip_open() 失败但没检查返回值；用 gpiod_line_request_output() 时传错 consumer 字符串（虽不影响功能，但日志污染）；或误以为 gpiod_line_set_value() 是原子操作，忽略了它底层仍需多次 ioctl。
- 如果你只是控制 LED 或继电器，
sysfs更快、更稳、代码更短 - 只有当你需要监听引脚边沿、同时被多个进程访问、或使用较新内核（5.5+）且禁用了
sysfs接口时，才值得上libgpiod - 注意：Raspberry Pi OS 默认仍启用
sysfs，libgpiod需手动安装libgpiod-dev包
别用 wiringPi（已废弃，且 BCM 编号映射混乱）
wiringPi 项目早在 2021 年就正式归档（archived），不再维护。它的 GPIO 编号系统混合了 wiringPi 编号、BCM 编号和物理编号，初学者极易搞混。例如 wiringPiSetupGpio() 后调用 digitalWrite(18, HIGH)，这里的 18 是 BCM 编号；但若用 wiringPiSetup()，18 就变成 wiringPi 自定义编号，对应 BCM 1 —— 完全不可靠。
- 编译时链接
-lwiringPi可能成功，但运行时调用digitalWrite()返回 -1（未初始化或权限不足），错误信息模糊 - 新版 Raspberry Pi OS（Bookworm）已移除
wiringPi包，apt install 会失败 - 已有项目迁移到
sysfs很简单：把digitalWrite(pin, val)拆成 open/lseek/write/close 即可
真正麻烦的不是写高/低电平本身，而是路径权限、文件偏移、编号映射这三处细节。一旦写错，现象往往是“没反应”，而不是报错，排查起来比逻辑错误还费时间。
