go通过接口解耦、context控制超时、显式资源管理实现跨平台硬件操作：串口需用带ctx的读写，gpio应建模为pin接口并按平台分离实现，所有硬件类型须实现io.closer，采用桥接模式而非继承，避免plugin动态加载。
Go 本身不提供硬件抽象层，但能通过标准库和第三方包安全、可控地对接串口、GPIO、I2C 等接口。关键不是“封装成类”，而是用接口解耦行为、用资源生命周期管理替代全局状态、用 context 控制超时与取消。
串口通信必须用 context.Context 控制读写超时
直接调用 serial.Open（如 github.com/tarm/serial）后裸读写，极易卡死在 Read 或 Write 上——尤其面对不可靠的嵌入式设备。没有超时机制，整个 goroutine 就挂住了。
- 所有 I/O 操作必须包装进带
ctx的函数，例如port.Read(ctx, buf)（需自行封装或选支持 context 的库，如github.com/jacobsa/go-serial） - 避免用
time.AfterFunc单独起 goroutine 去 cancel —— 它无法中断底层 syscall；正确做法是传入带 deadline 的context.WithTimeout - 打开串口失败时，检查
os.IsPermission和os.IsNotExist，而不是只看err != nil；Linux 下常见权限问题（/dev/ttyUSB0需要 udev 规则或用户加入 dialout 组）
GPIO 操作应统一建模为 Pin 接口，而非具体芯片驱动
不同开发板（Raspberry Pi、BeagleBone、ESP32）的 GPIO 控制方式差异极大，硬编码 gpio.WritePin(4, true) 会让模块彻底失去可移植性。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 定义最小接口：
type Pin interface { Set(high bool) error; Get() (bool, error) }，不暴露寄存器地址或芯片型号 - 实现层按平台分离：一个
rpiPin结构体用sysfs（/sys/class/gpio），另一个esp32Pin用machine包（TinyGo 生态） - 初始化时通过工厂函数注入，例如
NewPin("GPIO4", WithPlatform("rpi"))，避免 init 全局变量污染 - 务必在
defer pin.Close()中释放 sysfs 导出（unexport）或关闭设备文件，否则重复运行会报device or resource busy
硬件资源必须显式关闭，且不能依赖 finalizer
Go 的 runtime.SetFinalizer 不保证执行时机，而硬件句柄（文件描述符、内存映射区）泄漏会导致后续启动失败、权限拒绝或设备无法响应。
- 所有硬件操作类型（
SerialPort、Pin、I2CBus）都应实现io.Closer接口 - 业务逻辑中强制使用
defer dev.Close()，哪怕只做一次读写 - 若硬件操作被封装进 service（如
TemperatureReader），其Start()方法应返回func() error清理函数，由上层统一调用 - 不要在
Close()里重试失败操作（如反复写 GPIO），失败就记录日志并返回 error；调用方决定是否容忍
跨平台硬件适配优先用桥接模式，而非构建抽象基类
试图写一个 BaseHardware struct 并让所有设备继承它，在 Go 里既无效又危险——Go 没有继承，强行模拟只会导致指针误用和内存泄漏。
- 按桥接模式拆分：定义
Controller接口（高层行为，如ReadSensor()），再定义Driver接口（底层能力，如WriteReg(addr, data)） -
Controller持有Driver实例，完全不知道它是 I2C 还是 SPI；新增传感器只需实现Driver，无需改Controller - 生产环境避免用
plugin动态加载驱动（Windows 不支持、符号冲突风险高），改用配置驱动名 +map[string]func() Driver注册表 - 测试时用 fake driver（如
fakeI2C返回预设字节），不依赖真实硬件也能跑单元测试
真正难的不是打开一个串口或点亮一个 LED，而是让同一套业务逻辑能在树莓派、工控机、甚至无 OS 的 bare-metal 设备上以相同语义运行——这要求你从第一行代码就放弃“这个硬件永远在线”的假设，把每次访问都当作可能失败、需要上下文控制、必须显式释放的资源来对待。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
