tinygo 是独立编译器,非 go 包,不可用 go install;须用 brew 或 apt 安装,验证 tinygo version 和 which tinygo;target 必须精确匹配官方名称;uart 等外设需显式 configure;flash 不校验运行,main 必须存在且正确链接。

tinygo install 失败?别用 go install
你执行 go install github.com/tinygo-org/tinygo@latest 报错,不是你命令写错了,是根本走不通——TinyGo 不是 Go 包,它是个独立编译器,依赖 LLVM 和定制版 Go 工具链,go install 对它完全无效。
- macOS 用户直接运行
brew tap tinygo-org/tools && brew install tinygo - Ubuntu/Debian 用户确保启用官方源后运行
sudo apt-get install tinygo(注意:系统自带仓库常滞后,推荐从 tinygo.org/getting-started/ 下载 .deb) - 装完必须验证:
tinygo version有输出、which tinygo有路径,否则后续所有命令都会卡在第一步
build -target 选错,烧录成功但板子不亮
你看到 tinygo flash -target arduino main.go 显示 “SUCCESS”,但 LED 不闪、串口没输出——大概率是 target 错了。target 决定链接脚本、内存布局、启动代码和外设引脚映射,错一个字就可能生成无法运行的二进制。
-
tinygo targets查真实支持名,别猜缩写:pico❌,raspberry-pi-pico✅;esp32默认是 ESP32-S2,ESP32-C3 要显式写esp32c3 - Arduino Nano 33 BLE 是
arduino-nano33,普通 Uno 是arduino,二者芯片(nRF52840 vs ATmega328P)完全不同,混用必失败 - 烧录前先构建验证:
tinygo build -target=feather-m0 -o firmware.uf2 main.go,能出文件才说明 target 基本可用
machine.UART0.Write 没反应?缺 Configure 就等于没通电
你写了 machine.UART0.Write([]byte("hi")),串口监视器却一片空白——这不是驱动问题,是 TinyGo 的 UART 必须显式初始化,不调 Configure() 就像没给外设上电,Write() 会直接返回 0 或卡死。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合,支持请求回调和结构化解析。
- 必须配波特率:
uart.Configure(machine.UARTConfig{BaudRate: 115200}),漏掉这行,啥都白搭 - 不同板子默认 UART 引脚不同:Feather M0 用
SERIAL_TX_PIN,Pico 的 USB CDC 串口实际走machine.Serial,不是machine.UART0 - 某些芯片(如 ESP32)的 UART0 是下载口,运行时建议用 UART1,否则可能被烧录工具抢占
flash 成功但程序不跑?tinygo flash 不校验运行状态
tinygo flash 只负责把固件写进 Flash,它不管你的代码有没有入口、中断向量对不对、main 函数是否被链接进去。它说“成功”,只代表数据写入完成,不代表设备能执行。
- 确认
main()函数存在且无语法错误;TinyGo 不支持 init 函数自动调用,一切初始化逻辑必须在main()里显式写 - LED 不闪?先测最简 blink:
led := machine.LED; led.Configure(machine.PinConfig{Mode: machine.PinOutput}); led.High()——绕开循环和 sleep,排除时序干扰 - 用
tinygo build -x -target=xxx main.go看完整构建过程,重点检查 linker 是否报undefined reference to `main'或section `.text' will not fit
嵌入式 Go 最容易被忽略的,是“没有运行时兜底”——没 panic handler、没 GC、没 goroutine 调度器,main 函数一退出,芯片就停摆。你写的每一行,都得自己扛住硬件现实。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










