告别 gdal_translate：迎接 GDAL 统一命令行新时代

如果您是地理空间数据处理领域的一员，那么 GDAL/OGR 库想必是您工具箱中不可或缺的瑞士军刀。多年来，我们习惯了使用一系列独立的命令行工具，如 gdalinfo、gdal_translate、gdalwarp 和 ogr2ogr。它们功能强大，但数量繁多，有时我们不得不去翻阅文档，才能记起那个特定任务到底该用哪个命令。

现在，这一切都将成为历史。随着 GDAL 3.11 的发布，一个全新的、革命性的功能登场了——统一命令行界面（Unified CLI）。这不仅仅是一次小修小补，而是一次彻底的重构，旨在为您提供一个更一致、更直观、更强大的 GDAL 体验。

核心理念：从分散到统一

过去，每个工具都是一个独立的程序。而现在，所有的功能都被整合到了一个单一的入口点之下：gdal。

新的语法结构清晰明了，采用了分层设计：

gdal [领域] [操作] [选项] [参数]

这里的“领域”通常指代您正在处理的数据类型，如 raster（栅格）、vector（矢量）或 mdim（多维数据）。“操作”则是您想要执行的具体任务，如 info（获取信息）、convert（转换格式）或 reproject（重投影）。

image-20250711145835928

让我们看几个直观的例子：

  • 获取栅格信息：
    • 旧方法： gdalinfo my.tif
    • 新方法： gdal raster info my.tif
  • 转换矢量格式：
    • 旧方法： ogr2ogr poly.gpkg poly.shp
    • 新方法： gdal vector convert poly.shp poly.gpkg

这种层级结构让命令的查找和记忆变得异常简单。您不再需要记住十几个不同的程序名，只需从 gdal 开始，然后根据您的数据类型和意图，像浏览文件目录一样找到所需的功能。

gdal
├── raster
│   ├── info
│   ├── convert
│   ├── reproject
│   ├── pipeline
│   └── ...
├── vector
│   ├── info
│   ├── convert
│   ├── clip
│   ├── pipeline
│   └── ...
├── mdim
│   └── ...
└── ...

image-20250711145913870

王牌功能：强大的处理管道（Pipeline）

统一 CLI 带来的最令人兴奋的功能莫过于管道系统。想象一下，您需要对一个栅格数据进行读取、重投影、裁剪，最后再用特定的压缩方式写入新文件。在过去，这可能需要创建多个中间文件，或者编写一个复杂的脚本。

image-20250711145952649

现在，您可以使用管道将所有操作链接在一条命令中完成！

管道的语法模式如下，使用感叹号 ! 或竖线 | 作为步骤分隔符：

gdal [raster|vector] pipeline ! read [选项] 输入 ! [步骤1] [选项] ! [步骤2] [选项] ! ... ! write [选项] 输出

例如，将一个 GeoTIFF 文件重投影到新的坐标系并以云优化（COG）格式保存，可以这样做：

gdal raster pipeline ! read in.tif ! reproject --dst-crs=EPSG:32632 ! write --of=COG out.tif

这个命令优雅地将读取、处理和写入三个步骤串联起来，一气呵成，无需任何中间文件。这不仅简化了命令，还极大地提升了处理效率和工作流程的清晰度。

更棒的是，这些复杂的管道可以被序列化为一个 .gdalg.json 文件。这意味着您可以保存、分享和重用您的工作流，甚至可以将其作为一个虚拟数据集直接在 GDAL 中打开，实现即时的流式处理。

无缝迁移：从传统工具平滑过渡

对于老用户来说，改变使用习惯总需要一个适应过程。GDAL 开发团队贴心地提供了清晰的迁移路径。下面是一些常见命令的新旧对比，帮助您快速上手：

传统命令 统一 CLI 等效命令
gdalinfo my.tif gdal raster info --format=text my.tif
gdal_translate -of COG in.nc out.tif gdal raster convert --of=COG in.nc out.tif
gdalwarp -t_srs EPSG:4326 in.tif out.tif gdal raster reproject --dst-crs=EPSG:4326 in.tif out.tif
ogrinfo -al my.gpkg gdal vector info my.gpkg
ogr2ogr out.gpkg in.shp gdal vector convert in.shp out.gpkg

为开发者而生：完美的 Python 集成

统一 CLI 的设计理念贯穿了从终端到代码的整个生态。您可以在 Python 脚本中以同样简洁的方式调用这些功能，告别繁琐的 subprocess 模块。

from osgeo import gdal

# 使用 gdal.Run() 函数，就像在命令行中一样
# 参数以字典形式传入
result_dataset = gdal.Run("raster info", {"input": "my.tif"})

# 或者直接操作算法对象
info_alg = gdal.GetGlobalAlgorithmRegistry()["raster"]["info"]
info_alg["input"] = "my.tif"
info_alg.Run()
result_dataset = info_alg["output"].GetDataset()

这种集成确保了无论您是在命令行快速验证，还是在 Python 中构建复杂的自动化流程，都能拥有一致、可靠的接口。

结论：拥抱 GDAL 的未来

GDAL 统一 CLI 是地理空间数据处理领域一次意义深远的进步。它通过一致性、可发现性和可组合性（管道），极大地优化了用户体验。

虽然在 GDAL 3.11 中，该功能仍被标记为“临时的”（Provisional），意味着在未来的版本中可能会根据用户反馈进行微调，但它无疑指明了 GDAL 未来的发展方向。它将逐步取代传统的独立工具集，成为访问 GDAL 强大功能的标准方式。

是时候更新您的 GDAL，并开始探索这个崭新的世界了。从 gdal raster info 开始，体验一下这个现代、优雅、强大的新界面吧！