Python3环境下如何为gdal.Translate()添加进度条

gdal.Translate()和gdal.Warp()的进度回调逻辑完全一致，GDAL官方已经在接口中预留了进度回调参数，不需要手动拆分转换流程计算进度，直接按以下方法调用即可：

基础实现（原生Python，无额外依赖） #

from osgeo import gdal

# 自定义进度回调函数，参数为GDAL固定要求的格式
def progress_callback(complete, message, data):
    # complete为0-1之间的浮点数，代表当前完成比例
    percent = int(complete * 100)
    # 用\r实现行内进度刷新，避免重复打印多行
    print(f"转换进度: {percent}%", end="\r")
    # 回调函数必须返回1，否则GDAL会判定为需要终止操作，直接中断转换
    return 1

# gdal.Translate调用逻辑
input_path = "替换为你的输入栅格路径.tif"
output_path = "替换为你的输出栅格路径.tif"

# 可根据需求自定义Translate的参数，比如输出格式、重采样方式、裁剪范围等
translate_options = gdal.TranslateOptions(
    format="GTiff",
    resampleAlg=gdal.GRA_Cubic
)

# 调用时传入回调函数即可
ds = gdal.Translate(
    destName=output_path,
    srcDS=input_path,
    options=translate_options,
    callback=progress_callback,
    callback_data=None
)
# 转换完成后关闭数据集释放资源
ds = None
print("\n栅格转换完成")

进阶实现（结合tqdm实现美观进度条） #

如果需要更规范的进度条样式，可以结合Python常用的tqdm库实现，首先执行pip install tqdm安装依赖，再按以下代码调用：

from osgeo import gdal
from tqdm import tqdm

# 初始化全局进度条对象
pbar = tqdm(total=100, unit="%", desc="栅格转换中")

def progress_callback(complete, message, data):
    percent = int(complete * 100)
    pbar.n = percent
    pbar.refresh()
    return 1

# 核心转换逻辑和基础版本一致
input_path = "替换为你的输入栅格路径.tif"
output_path = "替换为你的输出栅格路径.tif"
translate_options = gdal.TranslateOptions(format="GTiff")

ds = gdal.Translate(
    destName=output_path,
    srcDS=input_path,
    options=translate_options,
    callback=progress_callback
)
ds = None
pbar.close()
print("转换完成")

注意事项 #

• 回调函数的返回值必须为1，返回0会直接中断GDAL的转换操作
• 如果同时运行多个GDAL转换任务，需要为每个任务单独初始化进度条对象，避免进度统计串线
• 进度比例由GDAL内部计算生成，不需要手动统计栅格大小、分块进度，比自行实现的进度逻辑准确率更高
• 如果出现from osgeo import gdal报错的情况，建议通过conda安装GDAL，或者下载对应版本的预编译whl包安装，避免源码安装的编译依赖问题

内容的提问来源于stack exchange，提问作者matt wilkie