Piwigo：用快速搜索和筛选找回照片

目标

用标题、文件名、描述或标签中的关键词找照片，再通过相册、作者、日期或文件属性缩小结果范围。

适用环境与准备

适用于 Piwigo 16.4.0 Web 图库。官方帮助文档为滚动页面，未在指定 16.4.0 部署或主题实测；不同主题的菜单位置会不同。 部分主题默认显示快速搜索栏；登录权限和图库当前可见范围会影响可搜索照片。准备一个照片标题、文件名、标签或描述中可能出现的词。

操作步骤

1. 在图库页面的快速搜索栏输入关键词并按 Enter。若主题没有直接显示搜索框，先查看主题菜单中的 Search 入口。
2. 浏览结果页。官方文档说明默认快速搜索会检查照片标题、文件名、描述、标签和照片 ID；若词语与标签或相册名相符，也可能显示 Tags found 或 Albums found 入口。
3. 在结果上方打开过滤栏，继续添加标签、相册或作者条件。Piwigo 14 及后续文档采用过滤栏细化搜索；Piwigo 16.4.0条目属于该版本范围，但页面是滚动文档。
4. 需要完整筛选页面时，按主题进入搜索页：Modus 常见入口为 Explore > Search，Bootstrap Darkroom 常见入口为 Discover > Search。具体入口取决于主题和菜单配置。
5. 在过滤栏选择要显示的条件。官方文档列出默认的关键词、标签、相册、作者筛选；还可添加上传日期（Post date）、照片创建日期、添加者、文件类型、宽高、长宽比、文件大小等。
6. 对标签条件，选择“所有所选标签”或“至少匹配一个标签”；对相册条件，可控制是否包含子相册。组合条件后查看动态更新的结果。
7. 如果从相册或标签页开始，使用页面提供的 Search in this set 按钮/图标（前提是图库启用了该入口），将搜索限制在当前集合。

预期结果

结果列表只显示满足当前关键词和筛选条件、且当前账户有权查看的照片。Post date 指文件导入图库的日期；Creation date 指照片文件创建日期。每位用户选择的可见过滤条件会保存为自己的设置。

常见问题与恢复

• **搜不到照片：**尝试照片可能使用的标题、文件名或标签词；检查是否只搜索了所有词而不是任一词；确认当前账户有权查看目标相册。
• **日期筛选结果意外：**先确认选的是上传日期还是文件创建日期；必要时改用自定义日期区间。
• **结果过少：**逐项移除过滤条件检查是哪一项限制了结果；Delete 可停用单个过滤器，Clear 可重置该过滤条件。
• **搜索入口没有显示：**按当前主题查菜单，并确认该图库是否启用了搜索栏或“Search in this set”入口。

FAQ

快速搜索会搜索照片说明吗？

默认会搜索标题、文件名、描述、关联标签及照片 ID；搜索编辑窗口允许调整搜索字段。

标签筛选是匹配全部还是任意一个？

可以选择匹配所有所选标签，或至少匹配其中一个。

Post date 和 Creation date 有什么区别？

Post date 是上传到 Piwigo 的日期；Creation date 是照片文件的创建日期，不能将两者混用。

来源与核验

后台软件资源：Piwigo 16.4.0，ID 6d64ff79-2f28-4375-a7db-78757b6e0fe8，revision 2，published。依据官方滚动用户文档整理，页面功能未逐项绑定16.4.0构建；未实测，无软件截图。核验日期：2026-10-16（Asia/Shanghai）。

• https://doc.piwigo.org/browsing-your-piwigo-gallery/search-for-a-photo-in-your-gallery/