gallery-dl日志配置：如何实现日志追加与自定义格式

日志追加模式配置

在gallery-dl项目中，要实现日志文件的追加写入而非覆盖，需要在配置文件中正确设置output.logfile的mode参数。许多用户容易混淆的是，这个参数并非放在顶层配置或logging配置块中，而是需要明确指定在output.logfile部分。

正确的配置示例如下：

{
    "output": {
        "logfile": {
            "path": "/path/to/your.log",
            "mode": "a",
            "level": "info"
        }
    }
}

其中mode参数支持两种模式：

• "w"：覆盖写入（默认值）
• "a"：追加写入

日志格式自定义

gallery-dl的日志系统支持自定义格式，但可用的替换字段有一定限制。除了标准的LogRecord属性外，还可以访问以下对象及其属性：

1. 当前提取器(extractor)对象
2. 当前任务(job)对象
3. 路径(path)对象
4. 关键词(keywords)对象

例如，可以通过{keywords.post_id}访问帖子ID，{extractor.url}获取当前提取的URL等。但需要注意，这些字段的值可能为空或引用前一个文件的信息。

最佳实践建议

1. 对于长期运行的下载任务，建议使用追加模式("a")，这样可以保留历史日志信息。

2. 在自定义日志格式时，建议包含足够的问题诊断信息，例如：

{
    "logging": {
        "format": "[{asctime}][{levelname}][{keywords.post_id}] {message}",
        "datefmt": "%Y-%m-%d %H:%M:%S"
    }
}

3. 对于关键操作，可以设置不同的日志级别：

• "debug"：详细调试信息
• "info"：常规操作信息
• "warning"：警告信息
• "error"：错误信息

通过合理配置日志系统和格式，可以更好地监控gallery-dl的运行状态，快速定位问题所在，特别是在批量下载或自动化任务中尤为重要。