Piwigo：替换照片文件并保留原有属性

目标

在不新建重复照片记录的情况下替换已有照片的文件，并保留这条照片记录上的属性。

适用环境与准备

适用于 Piwigo 16.4.0 Web 管理端。依据 Piwigo 官方滚动文档整理，未在指定构建实测。 该功能依赖 Photo Update 插件；未安装插件时编辑页不会有 Update 页签。替换文件会改变原照片内容，开始前先保存原始文件副本，并确认目标记录、文件格式、大小和新文件是正确版本。需要具备照片编辑权限。

操作步骤

1. 登录管理端，进入目标照片详情并核对照片缩略图、标题或其他唯一信息。
2. 备份当前源文件到站点之外的安全位置，确认备份可读取。
3. 如果还未启用插件，先由站点管理员安装并启用 Photo Update。插件安装不是此教程中的实测步骤；按当前插件与站点版本说明操作。
4. 重新打开照片编辑页，确认出现 Update 页签。官方文档说明该页签由插件新增。
5. 在 Update 页签选择准备好的替换文件并按页面提示上传。官方说明插件会替换原文件，同时保留照片属性；本教程未实测具体上传表单字段。
6. 上传后返回同一照片记录，核对缩略图/大图显示新内容，并检查标题、描述、作者、标签等原属性仍符合预期。
7. 只有确认替换结果正确后，才考虑保留或清理备份；在复核之前不要删除原文件副本。

预期结果

图库仍是同一条照片记录，文件内容更新，而照片属性保留。若同一照片记录、文件或属性对不上，应停止继续操作并使用备份恢复。

常见问题与恢复

• **找不到 Update 页签：**确认 Photo Update 插件已安装并启用，再重新打开照片编辑页；不要把普通编辑页当作支持替换文件。
• **替换后图片错误或损坏：**先暂停对外分享；用原始文件备份再次通过插件更新该照片。若插件状态异常，联系站点管理员检查日志。
• **照片属性似乎变化：**确认仍在原照片记录而非新建的另一条记录；查看标题、标签和相册后再判断。官方承诺的是保留属性，本文未实测。
• **想从外部文件同步照片：**不要假设 Photo Update 与 FTP 同步相同；按站点配置和官方同步说明选用对应流程。

FAQ

Photo Update 是 Piwigo 默认内置功能吗？

不是。官方文档说明需要安装插件，启用后编辑页才出现 Update 页签。

替换源文件会新建一条照片记录吗？

官方文档描述是在编辑页替换已有文件并保留属性；这与重新上传为新照片不同。

可以不备份直接替换吗？

不建议。替换内容有误时，保留原始文件副本可用于恢复。

来源与核验

后台关联资源：Piwigo 16.4.0，ID 6d64ff79-2f28-4375-a7db-78757b6e0fe8，revision 2，published。官方文档是滚动页面，未逐项映射到该版本；未实测，无软件截图。核验日期：2026-10-16（Asia/Shanghai）。

• https://doc.piwigo.org/import-and-manage-photos/modifying-or-deleting-photos/