gomobile不是ui框架，仅将go函数编译为android aar或ios framework供原生调用；必须指定合法module路径（不支持.），android需main包含main函数，ios需//export注释导出函数。
gomobile 不是移动端 UI 框架，它只做一件事：把 Go 函数编译成 Android AAR 或 iOS Framework，供原生代码调用。你不能用它写完整 App 界面，也不能直接操作 View、Activity、ViewController。
gomobile build/bind 命令总报 “no Go files in current directory”
这不是路径没找对，而是 gomobile 根本不认 .（当前目录）作为包路径。它强制要求你提供一个**合法的 module 路径**，且该路径下必须有可构建的 Go 包。
- Android 用
gomobile build：目标包必须含main函数，且包名是main；路径示例：gomobile build -target=android -o app.aar github.com/your/repo/app - iOS 用
gomobile bind：目标包不能有main函数，但必须有//export FuncName注释的导出函数；路径示例：gomobile bind -target=ios github.com/your/repo/mathlib - 确保项目根目录有
go.mod，且go list -f '{{.Dir}}' github.com/your/repo/app能正确输出路径 - 别在
go.work环境下直接运行 —— gomobile 不识别它
Java/Kotlin 或 Swift 调用后崩溃，log 显示 EXC_BAD_ACCESS 或空指针
根本原因是 Go 的内存模型和原生平台完全隔离。所有跨语言传递的数据，必须是 C 兼容类型，否则就是未定义行为。
- 允许的参数/返回值：基础类型（
int,float64）、C 指针（*C.char,*C.int）、C 数组（[]C.int），但不能是[]byte、map[string]int、struct、channel - 字符串必须用
C.CString转换，且 Java/Kotlin 或 Swift 侧必须显式C.free（Kotlin 中用memScoped，Swift 中用withUnsafePointer+deallocate） - 禁止在导出函数里启动 goroutine 并异步写回结果 —— 没有回调机制，必须同步返回
- iOS 上 Swift 调用前需加
@objc，且方法名首字母自动转小写（Add→add）
生成的 AAR/Framework 体积动辄 20MB+，远超预期
这是设计使然，不是配置错误。gomobile 默认静态链接整个 Go 运行时（GC、调度器、net/http、runtime 等），哪怕你只导出了一个 Add 函数。
- Android 可精简：加
-ldflags="-s -w"去除符号表和调试信息，命令形如gomobile bind -ldflags="-s -w" -target=android github.com/your/repo/lib - iOS 无法剥离运行时，但可限制架构：避免同时打
arm64和simulator，改用gomobile bind -target=ios/arm64 github.com/your/repo/lib - 移除所有重型依赖：删掉
log,encoding/json,net/http；可信输入下用unsafe+C手写简单解析逻辑 - 不要试图用
go:buildtag 控制运行时组件 —— gomobile 不支持按需链接
gomobile init 卡住或报 x509 / TLS handshake timeout
gomobile init 本质是从 Google CDN 下载预编译工具链（gobind、NDK 兼容层等），走 HTTPS，受系统代理和证书信任链直接影响。
- 国内用户：临时关闭系统代理，或设
https_proxy=http://127.0.0.1:7890（注意只读https_proxy，不读HTTP_PROXY） - macOS 企业环境：若用了自签 CA，需将证书拖进「钥匙串访问 → 系统」并右键 → 「显示简介 → 信任 → 始终信任」
- 可跳过自动下载：手动从
https://dl.google.com/go/mobile/下对应平台的gomobile-*.tar.gz，解压到$GOPATH/pkg/gomobile/，再运行gomobile init -v - Android 构建时报
libgojni.so not found：大概率是 ABI 不匹配，明确指定-target=android/arm（armeabi-v7a）或-target=android/386（x86 模拟器）
最常被忽略的一点：gomobile 对 Go 类型系统的约束是硬性的，不是建议。任何越界使用（比如传 struct、开 goroutine、用 context）都不会报编译错误，但会在运行时崩溃，而且堆栈几乎不提供有效线索。动手前先确认函数签名是否 100% 符合 C 兼容规则，比事后 debug 快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
