TinyGo编译失败主因是main.go位置错误或包名不符：必须置于go.mod同级根目录，文件名严格为main.go且首行为package main；tinygo build需在该目录执行，不支持子路径；target名称须精确匹配（如raspberry-pi-pico非pico），否则烧录后板子无响应。
TinyGo 编译失败，大概率是 main.go 放错了位置或包名不对
Go 原生工具链根本无法生成裸机二进制，go build 或 go install 跑 TinyGo 项目必然报错，比如 no Go files in 或 cannot load runtime/cgo。TinyGo 是独立编译器，不认子目录、不认非 main 包。
-
main.go必须放在go.mod所在的根目录下，不能在./cmd/、./src/或任何子文件夹里 - 文件必须叫
main.go，且第一行严格为package main（不是package main_test，也不能带下划线） - 执行
tinygo build时，当前工作目录必须是含go.mod和main.go的目录；不能写成tinygo build ./cmd/main.go - 若还没
go.mod，先运行go mod init example.com/blink—— 模块名无关紧要，但结构必须合规
target 名字写错，烧录成功但板子完全没反应
这是最隐蔽也最常被忽略的问题。tinygo flash -target=xxx 中的 xxx 不是“差不多就行”，它直接决定内存布局、启动代码、引脚映射和烧录协议。选错 target，固件可能写进去了，但芯片卡死在复位向量，LED 不闪、UART 不吐字。
- 不要凭经验缩写：
pico❌，正确是raspberry-pi-pico；micro:bit❌，正确是microbit - 芯片家族完全不同：Arduino Uno（
arduino）用 ATmega328P，Arduino Nano 33 BLE（arduino-nano33）用 nRF52840，混用必失败 - ESP32 系列必须区分清楚：
esp32默认指 S2，C3 要写esp32c3，S3 是esp32s3，分区表和 USB 引脚全不一样 - 验证方法：先跑
tinygo build -target=feather-m0 -o test.elf main.go，再用readelf -s test.elf | grep LED看符号是否解析成功
machine.UART0.Write() 没输出，其实是忘了 Configure()
TinyGo 不会自动初始化任何外设。调 uart.Write() 前没调 uart.Configure()，等于没给 UART 上电——函数立即返回 0 或卡住，串口监视器一片空白，不是硬件问题，是漏了一行代码。
立即学习“go语言免费学习笔记（深入）”；
- 必须显式配置波特率：
uart.Configure(machine.UARTConfig{BaudRate: 115200})，漏掉这行，啥都白搭 - 不同板子默认 UART 引脚不同：Feather M0 用
machine.SERIAL_TX_PIN，Arduino target 根本不支持硬件 UART，只能 bit-banging - Pico 板注意：
machine.UART0对应 GPIO 12/13，不连 USB；想用 USB 串口，得用machine.Serial（CDC ACM） - 调试技巧：在
Configure()后加time.Sleep(time.Millisecond * 10)，尤其主频低时，给 UART 寄存器稳定时间
tinygo flash 显示 SUCCESS，但程序根本不跑
tinygo flash 只负责把二进制写进 Flash，它不校验入口地址、不检查中断向量表、也不管 main 函数有没有被链接进去。它说“成功”，只代表数据写入完成，不代表设备能执行。
- 烧录前务必先构建验证：
tinygo build -target=arduino-nano33 -o firmware.uf2 main.go，能出文件才说明 target 基本可用 - 某些开发板（如 STM32F4 Discovery）没有原生 CDC/DFU，
tinygo flash默认不支持，得靠 ST-Link 或 OpenOCD 手动刷.bin - 生成裸机二进制时注意：
-x参数表示跳过链接启动文件（由 target 自带），例如tinygo build -target=stm32f4disco -o firmware.bin -x main.go - 如果板子插着但
tinygo flash找不到设备，先确认是否进入编程模式（比如双击 Pico 的 BOOTSEL）、驱动是否装好、Linux 下是否加了 udev 规则或 sudo 权限
真正卡住人的地方，往往不是语法或逻辑，而是 target 名字差一个字符、main.go 多套了一层目录、或者 UART 少调了一次 Configure() —— 这些细节不报错，但会让整个系统静默失效。
