TinyGo编译报“no Go files in”因入口必须为根目录main.go；烧录失败需检查权限、驱动及下载模式；GPIO需查板型文档匹配逻辑引脚；串口乱码须统一波特率并先初始化UART。
tinygo build 报错 “no Go files in”
这是最常遇到的卡点：TinyGo 不是直接编译普通 Go 项目，它要求入口文件必须是 main.go，且必须放在模块根目录（即 go.mod 所在目录），不能套在子文件夹里。
常见错误现象：tinygo build -target=arduino -o firmware.hex ./cmd/main 这种写法会失败，因为 TinyGo 不支持子路径作为主包入口。
- 确保当前工作目录下有
main.go和go.mod -
main.go必须包含func main()，且不能是package main_test或其他包名 - 如果用
go mod init example.com/blink初始化，模块名本身不重要，但main.go必须在该目录下 - ESP32 用户注意：某些板型（如 ESP32-DevKitC）需额外指定
-target=esp32，而非arduino；Arduino Nano 33 BLE 则要用-target=arduino-nano33ble
串口烧录失败，设备找不到或权限拒绝
TinyGo 编译完只是生成固件二进制（如 firmware.hex 或 firmware.bin），烧录依赖底层工具链（esptool.py、avrdude 等），不是 Go 自己搞定的。
常见错误现象：tinygo flash 报 failed to open port /dev/ttyUSB0: permission denied，或 No serial ports found。
立即学习“go语言免费学习笔记（深入）”；
- Linux 下先加用户到
dialout组：sudo usermod -a -G dialout $USER，然后重新登录终端 - macOS 上检查是否装了正确驱动，CH340 芯片（常见于国产 Arduino 兼容板）需手动装 WCH 驱动，而不是用系统自带的 CDC 驱动
- ESP32 烧录前要按住
BOOT键再按EN进入下载模式——很多板子没这步就一直连不上 - 用
tinygo flash -target=esp32 -port=/dev/tty.usbserial-XXXXX显式指定端口，避免自动探测失败
GPIO 控制不生效，LED 不亮或引脚电平异常
微控制器的引脚编号和开发板丝印标注不一致是常态。TinyGo 的 machine.Pin 是逻辑编号（比如 machine.LED），不是物理引脚号，也不是 Arduino 的 LED_BUILTIN。
使用场景：想控制板载 LED，但写 led := machine.Pin(13) 没反应。
- 优先查 TinyGo 官方支持的板型文档页（如 Arduino 支持列表），确认
machine.LED对应哪个物理引脚 - Arduino Uno/Nano：通常是
machine.Pin(13)；Arduino Nano 33 BLE：是machine.Pin(22)；ESP32 DevKitC 板载 LED 多数接在 GPIO2，所以用machine.Pin(2) - 注意方向设置：必须调用
led.Configure(machine.PinConfig{Mode: machine.PinOutput})，否则写操作无效 - 某些 ESP32 引脚（如 GPIO6–GPIO11）连接内部 Flash，运行时不可用作通用 GPIO，强行配置可能触发复位
启用 UART/Serial 时 log 输出乱码或卡死
TinyGo 的 machine.Serial 默认波特率是 115200，但很多终端工具（如 Arduino IDE Serial Monitor、screen、minicom）默认可能是 9600，不匹配就会显示乱码；更隐蔽的问题是未初始化就调用 fmt.Println。
常见错误现象：串口打印一堆 ，或者程序在 fmt.Println("hello") 处卡住不动。
- 初始化顺序很重要：必须先
machine.Serial.Configure(machine.UARTConfig{BaudRate: 115200})，再使用fmt或log - ESP32 启动时默认从 UART0（GPIO1/TX, GPIO3/RX）输出启动日志，如果你把外设也接到这两个脚，会冲突——换用 UART1（需指定
TX: machine.Pin(17), RX: machine.Pin(16)） - Arduino 板型中，
machine.Serial实际映射到 USB CDC 接口，不是硬件 UART，所以无需额外接线，但 macOS 上可能识别为/dev/cu.usbmodem...而非tty - 调试建议：先用
tinygo flash -target=arduino烧录一个只点灯不串口的版本，确认硬件正常，再加串口逻辑
真正麻烦的从来不是编译成功，而是引脚定义和时序细节藏在芯片手册第 83 页的小字里，而 TinyGo 文档往往只写“支持该芯片”，不写“这个引脚在该型号上被复用为 JTAG”。动手前多翻 datasheet，比反复重烧快得多。
