tinygo是独立编译器而非go插件，必须通过系统包管理器（如apt、homebrew、scoop）安装，禁用go install；依赖llvm工具链，需单独安装llvm-dev/libclang-dev或llvm；target参数须严格匹配硬件型号，外设使用前必须显式configure()。
tinygo 不是 go 的插件或扩展，它是个独立编译器，装错方式就完全跑不起来——比如用 go install 装 github.com/tinygo-org/tinygo 必然失败，报错通常是 no Go files in 或链接 LLVM 失败。
tinygo install 失败？别碰 go install
你看到的任何教程写 go install github.com/tinygo-org/tinygo@latest，直接跳过。TinyGo 和 go 命令完全无关，它的二进制是独立构建、预编译好的。
- Linux（Ubuntu/Debian）：加官方源后执行
sudo apt install tinygo，别用apt-get install golang-go混淆 - macOS：用 Homebrew，先
brew tap tinygo-org/tools再brew install tinygo - Windows：推荐 Scoop，
scoop bucket add tinygo https://github.com/tinygo-org/scoop-tinygo.git然后scoop install tinygo - 验证是否装对：
tinygo version有输出，且which tinygo返回有效路径
LLVM 缺失导致 llvm-config: command not found
tinygo 依赖 LLVM 工具链生成机器码，没它连最基础的 build 都会卡住。
- Ubuntu/Debian：装
llvm-dev libclang-dev，不是llvm单包 - macOS：
brew install llvm，装完检查llvm-config --version是否可执行 - Windows（Scoop）：Scoop 安装
tinygo时会自动拉取 LLVM，但手动解压 ZIP 包方式需额外配置LLVM_SYS_180_PREFIX环境变量指向 LLVM 安装路径 - 验证：运行
tinygo build -o /dev/null examples/blinky.go，不报llvm-config错就是过了
target 选错，烧录成功但板子没反应
这是最隐蔽也最常踩的坑：固件写进去了，LED 不闪、串口没输出，问题不在硬件，而在 -target 参数和芯片实际型号不匹配。
-
arduino≠arduino-nano33≠feather-m0：ATmega328P、nRF52840、ATSAMD21 是不同架构，引脚映射、启动代码、内存布局全不一样 - ESP32 系列必须严格区分：
esp32、esp32c3、esp32s3，USB/UART 引脚和分区表默认配置完全不同 - 查准名字：运行
tinygo targets列出所有支持项，pico错，得用raspberry-pi-pico；micro:bit错，microbit才对 - 不确定时，先
tinygo build -target=xxx -o test.elf main.go，再用readelf -s test.elf | grep LED看符号是否解析成功
machine.UART0.Write() 没输出？外设没配等于没接线
TinyGo 不会自动初始化任何外设。调 uart.Write() 前没调 uart.Configure()，函数立刻返回 0 或卡死，串口监视器一片空白。
- 必须显式配置：
uart.Configure(machine.UARTConfig{BaudRate: 115200})，否则寄存器保持复位值 - 引脚由
-target决定：比如feather-m0默认用machine.SERIAL_TX_PIN，但arduinotarget 根本不支持硬件 UART，只能 bit-banging - Pico 板注意：
machine.UART0对应 GPIO 12/13，不连 USB；想用 USB 串口，得用machine.Serial（CDC ACM） - 调试技巧：在
Configure()后加time.Sleep(time.Millisecond * 10)，给外设稳定时间
真正卡住的地方往往不是语法或逻辑，而是 target 名字拼错、LLVM 路径没暴露、或者 UART 少写了一行 Configure() —— 这些点不手动验证，光看烧录成功日志毫无意义。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
