在Android中使用LibGDX加载TileMap遇zstd压缩不识别错误求助
2026-5-8
解决LibGDX加载TMX时的zstd压缩不支持问题
你的代码本身没毛病，问题出在Tiled导出的TMX文件上——当前版本的LibGDX TmxMapLoader不支持zstd格式的图层数据压缩，这就是报错Unrecognised compression (zstd) for TMX Layer Data的核心原因。
快速修复步骤：
- 打开你的Tiled项目，选中对应图层（或所有图层）
- 在右侧的图层属性面板里，找到「Layer Data Format」（图层数据格式）选项
- 将压缩格式替换为LibGDX官方支持的类型，推荐选这几种：
Base64 (uncompressed)：无压缩，调试阶段最稳妥Base64 (gzip)：gzip压缩，LibGDX完全兼容，还能减小文件体积CSV：纯文本格式，可读性强，适合简单地图
- 重新导出TMX文件，覆盖assets目录里的旧文件
- 重启程序，这个报错应该就消失了
额外说明：
如果你的项目必须用zstd压缩，那得自己扩展BaseTmxMapLoader类，添加zstd格式的解析逻辑，但这需要熟悉LibGDX地图加载的源码，对新手来说门槛较高。所以优先推荐上面修改压缩格式的方案。
内容的提问来源于stack exchange，提问作者kim
相关产品推荐
相关产品推荐
