gomobile bind 生成的符号名带下划线是因启用C ABI兼容模式以避免命名冲突，Swift/Java中必须使用\_MyStruct、\_MyFunc等格式，不可删除下划线，需通过首字母大写命名提升可读性。
gomobile bind 生成的 Go 符号名为什么带下划线？
因为 gomobile bind 默认启用 C ABI 兼容模式，所有导出函数/类型在 Swift/Java 层都会被加上前缀 _，这是为了规避 Objective-C/Swift 的命名冲突机制——Go 没有命名空间，而 iOS 原生桥接层（libgo.dylib）靠符号重命名隔离。
常见错误现象：MyStruct 在 Swift 里变成 _MyStruct，调用 MyFunc() 报错 “Use of unresolved identifier 'MyFunc'”；Java 侧则看到 _MyFunc 方法而非预期名。
- 这不是 bug，是 gomobile 的设计行为，不可通过参数关闭
- Swift 中必须按
_MyStruct、_MyFunc(...)使用，不能手动删下划线 - Java 侧同理，类名、方法名、字段名全部带
_前缀，例如new _MyStruct() - 如果你依赖第三方 Swift/Java 工具链（比如某些 JSON 序列化库），它们可能不识别带下划线的类名，需手动适配或换用反射绕过
如何让 Go 函数在 Swift/Java 中看起来“自然”一点？
不能去掉下划线，但可以控制它后面的部分：Go 导出名本身决定最终符号主体。golang 规范要求首字母大写才导出，而 gomobile 会原样保留大小写，所以命名策略直接决定桥接层可读性。
使用场景：你希望 Swift 调用时写 _FetchUser(id: 123) 而不是 _fetch_user(id: 123)，后者在 Swift 里不符合命名习惯，且 Java 侧方法名也会是小写开头（违反 JavaBean 规范）。
立即学习“Java免费学习笔记（深入）”；
- Go 端函数/结构体名必须首字母大写，如
FetchUser、UserModel - 避免用下划线分隔单词（
fetch_user→ 不导出；Fetch_User→ 生成_Fetch_User，更糟） - 不要试图用
//export注释或 cgo 指令干预，gomobile bind不走 cgo 导出路径，这些注释会被忽略 - 如果已有小写开头的函数需要暴露，只能封装一层大写导出函数，例如：
func FetchUser(id int) { return fetchUser(id) }
Android Java 侧调用时 ClassNotFound 或 NoClassDefFoundError 怎么办？
错误信息典型为：java.lang.ClassNotFoundException: Didn't find class "_MyModule" 或运行时报 NoClassDefFoundError: _MyModule。根本原因不是 Go 代码问题，而是 Android 构建流程没把 gomobile 生成的 AAR 正确集成进项目。
性能 / 兼容性影响：AAR 包含 native so 库（arm64-v8a、armeabi-v7a 等），若 ABI 不匹配或未配置 abiFilters，会导致类加载失败或闪退。
- 确认你用的是
gomobile bind -target=android，不是默认的ios - AAR 必须放在
app/libs/下，并在app/build.gradle中声明：implementation(name: 'mylib', ext: 'aar') - 检查
android/app/build.gradle的defaultConfig是否设置了ndk { abiFilters 'arm64-v8a', 'armeabi-v7a' }，且与 gomobile 生成的 so 架构一致 - Java 代码中必须 import 完整包名，例如：
import mypackage._MyModule;（注意包名来自-javapkg参数或模块路径）
Swift 调用时 crash 在 libgo.dylib 或报 EXC_BAD_ACCESS
这类 crash 多数发生在 Go 回调传参、字符串/切片跨语言传递，或 GC 时机不一致。不是 Swift 写错了，而是 Go 层没做内存生命周期管理。
常见错误现象：Swift 调用 _DoSomething(str: "hello") 后立刻 crash；或回调函数里访问 data[:] panic；或多次调用后内存暴涨。
- Go 字符串传给 Swift 会转成
NSString*，但 Go 字符串底层是只读的，Swift 侧不可修改，否则 crash - Go 切片（
[]byte）传过去是NSData*，同样不可写；如需修改，必须在 Go 层复制一份再返回 - 所有回调函数（
func(fn func())）必须确保 Go 函数对象在 Swift 调用期间不被 GC 回收，推荐用runtime.KeepAlive(fn)或显式持有引用 - 避免在回调里启动 goroutine 并长期持有 Swift 对象指针——Swift 对象可能已被释放，Go 层再访问就是野指针
复杂点在于：这些错误不会在编译时报出，也不会有明确日志，只有 runtime crash。最容易被忽略的是回调中的 goroutine 生命周期和跨语言内存所有权边界。
