封装 LZ4 算法的 C 语言实现，通过 JNI / FFM 绑定为 Java 可调用的本地方法，向 org.lwjgl.util.lz4 包提供底层入口，是 Java 侧调用 LZ4 的唯一原生载体。

提供块级压缩、安全解压以及 LZ4 HC 高压缩比模式。其解压吞吐可达 GB/s 量级，压缩速度显著快于 gzip / deflate，适合对延迟高度敏感的实时场景。

支持 LZ4 Frame 规范，可进行分块、流式的压缩与解压，携带内容大小、块校验和、字典等元数据，便于持久化存储与跨进程数据交换。

与 MemoryStack、MemoryUtil 协作，直接在 DirectByteBuffer 与本地内存上读写，避免 JVM 堆内数据复制，降低 GC 压力，适合处理区块、纹理、资源包等大体积数据。

作为 LWJGL 原生库集合的一部分，由库加载器按操作系统与 CPU 架构（Windows x64 / arm64）解析并载入，与 lwjgl.dll 等文件同步发行，版本必须保持一致。

• 加载期异常：程序启动即抛出 UnsatisfiedLinkError，提示 “no lwjgl_lz4 in java.library.path”，或抛出 LibraryNotFoundException，LZ4 相关类的本地方法无法完成绑定。
• 程序无法启动：该库的加载通常写在静态初始化块或启动流程中，缺失会导致游戏、启动器、资源打包工具直接闪退、黑屏或卡死在加载界面。
• 功能失效：存档、资源包、区块数据、网络封包的压缩与解压链路中断，表现为读取失败、数据损坏或出现损坏数据的提示。
• 性能退化：部分软件会回退到纯 Java 的 Deflate / GZIP 实现，压缩率与吞吐量下降，CPU 占用明显升高。
• 排查困难：异常栈往往只显示底层 native 调用，需要核对 java.library.path、LWJGL 版本与系统位数是否匹配。