深入解析immich-go中的文件名日期解析机制

immich-go作为一款优秀的照片管理工具，其日期解析功能对于照片整理至关重要。本文将全面剖析immich-go如何从文件名和路径中提取日期信息，帮助用户更好地组织照片库。

日期解析的核心逻辑

immich-go采用多层次的日期解析策略，按照以下优先级顺序尝试获取照片的拍摄日期：

1. EXIF元数据：首先检查照片文件内嵌的EXIF信息，这是最准确的日期来源
2. JSON关联文件：针对Google Photos导出的文件，会读取关联的JSON文件获取日期
3. 文件名解析：当上述方法不可用时，会尝试从文件名中提取日期
4. 路径解析：最后会检查文件所在路径中是否包含日期信息

文件名日期解析规则

immich-go使用正则表达式(\d{4})\D?(\d\d)\D?(\d\d)\D?(\d\d)?\D?(\d\d)?\D?(\d\d)?来解析日期，该规则具有以下特点：

• 必须包含完整日期：必须包含年(yyyy)、月(mm)、日(dd)三部分才能被识别
• 灵活的格式分隔：各部分之间可以使用任意非数字字符分隔
• 时间部分可选：小时、分钟、秒是可选的

有效日期格式示例

以下文件名格式都能被正确解析：

IMG_20230325.jpg
2023-03-25_IMG123.jpg
2023w03m25T131313.jpg
2023_03_25_13_13_13.jpg

无效日期格式示例

以下情况将无法被解析：

2023.jpg                  # 缺少月和日
2023-03.jpg               # 缺少日
2023年3月.jpg             # 包含非ASCII字符
2023 Crete Vacation.jpg    # 日期格式不匹配

路径解析策略

当文件名中不包含日期时，immich-go会检查文件路径：

1. 从文件名开始，逐级向上检查每个目录名
2. 如果某级目录名中包含有效日期，则使用该日期
3. 如果所有目录名都无日期，则尝试对整个路径进行日期匹配

路径解析示例

以下路径结构都能被正确解析：

/Photos/2023/03/25/IMG123.jpg    # 从路径中获取2023-03-25
/Vacation/2023-03-25/IMG123.jpg  # 从目录名获取2023-03-25

最佳实践建议

为了确保照片日期能被正确识别，建议采用以下命名规范：

1. 优先保证EXIF信息完整：这是最可靠的日期来源
2. 统一命名格式：建议使用yyyy-mm-dd或yyyy_mm_dd格式
3. 避免歧义格式：不要使用dd-mm-yyyy等可能引起混淆的格式
4. 层级目录结构：可以建立/年/月/日/的目录结构辅助管理

通过理解immich-go的日期解析机制，用户可以更有效地组织照片库，确保所有照片都能被正确归类并按时间排序。