必须通过AAssetManager读取assets文件，因assets是APK内只读ZIP资源；需Java传入AssetManager并调用AAssetManager_fromJava()获取句柄，再用AAsset_open()配合正确mode打开，注意路径大小写敏感、不可遍历上级目录，且需确认文件已实际打包进APK。
Android NDK 里用 AAssetManager 打开 assets 文件
在 C++（NDK）中读取 assets/ 下的文件，不能用标准 C 的 fopen() 直接路径访问——因为 assets 不是普通文件系统路径，而是打包进 APK 的只读资源归档。必须通过 Android 提供的 AAssetManager 接口。
关键前提：你得从 Java 层把 AssetManager 对象传进来（通常通过 JNIEnv* 和 jobject 参数），再用 AAssetManager_fromJava() 转成原生句柄。
-
AAssetManager*必须由 Java 侧传入，NDK 自己无法凭空创建 - 常见错误：在
onLoad()或静态初始化时就调用AAssetManager_fromJava()，但此时jobject还没传入，导致返回nullptr - 推荐做法：把
AAssetManager*存为全局或模块级变量，在第一个 JNI 函数被调用时初始化
用 AAsset_open() 获取可读流，注意 mode 参数
AAsset* 是一个类似 FILE* 的句柄，但行为更受限。打开后只能顺序读、不支持 seek()（除非用 AASSET_MODE_BUFFER 加载全量到内存）。
-
AAsset_open( mgr, "data/config.json", AASSET_MODE_STREAMING )：适合大文件，底层走流式解压，不可回溯 -
AAsset_open( mgr, "shaders/vert.glsl", AASSET_MODE_BUFFER )：小文本/二进制文件首选，一次性加载进内存，支持AAsset_getLength()和随机读 - 别用
AASSET_MODE_UNKNOWN——它不是“自动识别”，而是未定义行为，某些旧版本会直接返回nullptr
读取失败时看 AAsset_getRemainingLength() 和 errno
很多人卡在“打开成功但读不出数据”，其实是因为 asset 被压缩了（APK 默认对非白名单后缀做 zip 压缩），而 AASSET_MODE_STREAMING 在压缩状态下无法正常工作。
- 先检查
AAsset_getLength(asset)是否 > 0；若为 0，大概率是路径错或文件被过滤掉了 - 读完后调用
AAsset_close(asset)—— 忘记关闭会导致后续打开失败（尤其在频繁加载资源时） - 如果
AAsset_read()返回值小于预期，且errno == EINVAL，说明 asset 实际是压缩状态，需改用AASSET_MODE_BUFFER或在build.gradle中配置aaptOptions.cruncherEnabled = false+ 白名单后缀
assets 路径区分大小写，且不支持 ../ 向上跳转
Android 的 asset 系统是 ZIP 内部路径映射，路径规则严格遵循 ZIP 规范：大小写敏感、无目录遍历、不识别 . 或 ..。
- 写
"textures/icon.png"可以，写"Textures/icon.png"或"textures/Icon.png"就打不开（即使你在 macOS 上开发也一样） -
AAsset_open(mgr, "../raw/data.bin", ...)永远失败，ZIP 不允许跨目录引用 - 调试时建议先用
AAssetDir*+AAssetDir_rewind()+AAssetDir_getNextFileName()列出所有可用文件名，确认拼写和层级
最常被忽略的是：assets 文件是否真的被打包进 APK。用 unzip -l app-debug.apk | grep yourfile 确认存在，比在代码里反复猜错误原因快得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
