GeoTIFF / COG 地理影像查看器打不开或显示异常？排错指南
按文件签名、版本、单位、坐标和浏览器资源顺序排查GeoTIFF / COG 地理影像查看器，并保留原始文件。
不要先改后缀或覆盖原文件
复制一个样本用于排错，保留原始交付文件、文件大小、生成软件版本和错误提示。打开一幅 4 波段 16 位影像，先记录 ModelPixelScale、Tiepoint 和地理边界，再尝试 3-2-1 真彩色。若画面全黑，不要判断文件为空，应根据统计值对每个波段做显示拉伸。
推荐排查顺序
- 用工具页面的示例或一份更小的同类文件确认浏览器功能正常。
- 检查文件签名与扩展名是否一致，确认文件没有被下载为 HTML 错误页。
- 对照工具支持格式、大小上限和下面的专业检查项。
- 关闭其他大型标签页，在最新版 Chrome 或 Edge 重试。
- 仍异常时回到创建该文件的软件重新导出，并在正式专业软件中复核。
针对这个格式的检查
- 宽高、波段数和位深与交付说明一致
- 地理变换能产生合理边界，轴顺序和南北方向没有颠倒
- NoData 不与有效值范围混淆
- COG 的 tile/overview 信息存在时可按块读取
常见错误与解决方法
显示正常但没有坐标
普通 TIFF 不含 GeoKey/Tiepoint；需要 sidecar world file 时，本版不会自动把它当 GeoTIFF。
坐标范围明显不合理
检查投影单位、轴顺序和错误 EPSG 声明；工具不会自动纠正或重投影。
哪些情况不能靠网页工具
- 不会自动识别所有 EPSG 定义或进行重投影
- 超大非 COG 文件可能占用大量内存
- 渲染拉伸仅用于预览，不是定量遥感分析
网页“能显示”只证明当前解析器读到了部分结构，不证明工程、生产、科研、商务或临床结果合规。正式交付应保留源软件和接收方的验证记录。
隐私与安全
本工具在浏览器本地读取文件，不会为解析而上传到 FreeTool。排错截图、导出 CSV 和浏览器下载仍可能包含敏感信息；共享前请脱敏，并在共享设备上清理这些副本。