TinyGo编译失败主因是main.go位置错误或包名不符：必须置于go.mod同级根目录，文件名严格为main.go且首行为package main；tinygo build需在该目录执行，不支持子路径；target名称须精确匹配（如raspberry-pi-pico非pico），否则烧录后板子无响应。
在开发板上直接运行 Go 程序不现实，Go 官方编译器不支持 ARM Cortex-M（如 STM32）或 RISC-V（如 Orange Pi AI Pro 的 NPU 协处理器）等裸机/微控制器目标；你真正能做的，是「交叉编译 + 上传固件」或「在开发板 Linux 系统中运行 Go 二进制」——两者技术路径完全不同，选错就白忙活。
tinygo build 报 “no Go files in” 是因为没放对 main.go 位置
这是 TinyGo 用户最常卡住的点：它不认 go mod 子模块结构，也不接受 ./cmd/main 这类路径写法。
-
main.go必须位于当前工作目录根下，且该目录必须有go.mod（哪怕只是go mod init example.com/blink） - 包声明只能是
package main，不能是package main_test或其他名字 - 使用
tinygo build -target=arduino -o firmware.hex时，命令必须在main.go所在目录执行，不能加任何子路径 - STM32F407 开发板需用
-target=stm32f407vg（查 TinyGo 官方支持列表），不是arduino—— 错配 target 会导致链接失败但报错不明确
Linux 类开发板（如 Orange Pi AI Pro）可直接装 Go 运行时
这类板子跑全功能 Linux（通常是 Ubuntu/Debian），和桌面系统无异，go 可以原生安装、编译、运行，但要注意 ABI 和内核版本兼容性。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认架构：
uname -m输出aarch64就选go1.21.11.linux-arm64.tar.gz，别错下成armv7 - 解压后把
bin加入$PATH，再设GOROOT指向解压路径（export GOROOT=$HOME/go） - 避免用
apt install golang—— Ubuntu 源里的 Go 版本太旧（常为 1.18），不支持泛型完善语法和新net/http特性 - 交叉编译反而没必要：直接在板子上
go build更可靠；若要从 x86_64 主机编译，得用GOOS=linux GOARCH=arm64 go build
串口日志乱码或烧录失败，大概率是权限或驱动问题
TinyGo 的 flash 命令本质是调用 esptool.py 或 openocd，失败提示往往藏在底层工具里，不是 Go 层面能捕获的。
立即学习“go语言免费学习笔记（深入）”；
- Linux 下设备节点（如
/dev/ttyUSB0）默认无读写权限：运行sudo usermod -a -G dialout $USER，然后完全退出终端重登 - macOS 上 CH340 芯片（常见于国产 STM32 板）必须手动装 WCH 驱动，系统自带 CDC 驱动会识别成无响应设备
- ESP32 烧录前务必按住 BOOT 键再按 EN，否则芯片处于运行模式，拒绝接收新固件
- 用
tinygo flash -port /dev/tty.usbserial-XXXX -target=esp32显式指定端口，禁用自动探测（自动探测在 USB Hub 下极不可靠）
真正容易被忽略的是：开发板的 UART 引脚电平（3.3V vs 5V）、TX/RX 是否反接、以及固件是否覆盖了 bootloader 区域。这些硬件层问题，不会在 Go 编译日志里体现，但会让你反复重试一整天。
