Immich项目存储模板条件逻辑使用注意事项

在Immich项目中使用存储模板时，开发者可能会遇到一个关于条件逻辑({{#if}})的特殊行为。本文将详细解释这一现象的原理、预期行为以及正确的使用方法。

问题现象

当用户尝试使用如下格式的存储模板时：

{{#if album}}{{album}}/{{else}}Other{{/if}}/{{y}}/{{MM}}/{{filename}}

实际生成的路径会出现不符合预期的结果：

• 有相册时：/AlbumName/y/MM/filename.jpg
• 无相册时：/y/Other/MM/filename.jpg

而用户期望的结果应该是：

• 有相册时：AlbumName/filename.jpg
• 无相册时：Other/2025/04/filename.jpg

技术原理分析

这种现象并非bug，而是模板引擎的条件逻辑({{#if}})的工作机制决定的。在模板引擎中，{{/if}}标记表示条件块的结束，之后的内容会被视为无条件执行的公共部分。

具体来说：

1. 条件块({{#if}}...{{/if}})内部的内容会根据条件判断结果选择性执行
2. 条件块结束后，所有后续内容都会无条件执行
3. 因此/{{y}}/{{MM}}/这部分路径会被添加到所有情况下

正确使用方法

要实现用户期望的目录结构，应该将条件逻辑完整包裹所有可能变化的部分：

{{#if album}}
  {{album}}/{{filename}}
{{else}}
  Other/{{y}}/{{MM}}/{{filename}}
{{/if}}

这种写法明确区分了两种情况的完整路径结构，避免了条件块后的公共内容干扰。

最佳实践建议

1. 完整路径原则：在条件逻辑中，最好定义完整的路径结构，而不是尝试复用部分路径

2. 清晰分隔：使用多行格式和缩进可以提高模板的可读性，便于维护

3. 测试验证：设置模板后，建议使用少量测试文件验证生成的路径是否符合预期

4. 文档参考：虽然本文解释了基本原理，但实际使用时还应参考项目的最新文档，了解可能的更新或增强功能

总结

Immich项目的存储模板功能提供了强大的灵活性，但需要正确理解模板引擎的工作机制。特别是条件逻辑的使用，开发者应该注意{{/if}}后的内容会被无条件执行这一特性。通过将不同情况下的完整路径分别定义在条件块内，可以确保生成的文件存储结构完全符合预期。