XnView MP 缩略图不显示怎么办？按设置、缓存和格式排查
简答：XnView MP 缩略图不显示，优先检查缩略图显示状态和 Catalog 缓存，再对当前目录执行 Rebuild thumbnails。先用本地短路径中的标准 JPEG、PNG 做对照：如果测试文件正常，问题多半集中在原文件格式、目录路径、权限或缓存；如果全部不显示，再检查程序设置和版本。
定义：XnView MP 缩略图是浏览器视图中由原图、文件内嵌缩略图或 Catalog 缓存生成的预览图，显示异常不一定代表原图损坏。
先做 5 分钟初筛：确定是设置、缓存还是文件问题
本文是对公开资料的第三方整理，不是 XnView MP 官方页面。XnView MP 支持多种常见图片格式，也支持 RAW、HEIC、AVIF 等格式，但不同格式的缩略图生成方式可能不同，具体能力应以当前版本和官方格式列表为准。官方 FAQ与官方格式列表可用于交叉核对。
| 现象 | 先做什么 | 如何判断 |
|---|---|---|
| 所有图片都没有缩略图 | 检查浏览器视图、过滤条件和 Catalog 缓存 | 换一个本地目录，查看是否仍然空白 |
| 只有某一种格式没有 | 用 JPEG 或 PNG 做对照 | JPEG/PNG 正常时，继续核对该格式是否受当前版本支持 |
| 只有一个目录没有 | 复制少量文件到本地短路径 | 本地测试正常时，重点检查原目录权限、网络共享或路径问题 |
| 缩略图是空白或很久才出现 | 检查缓存是否启用并重建当前目录 | 重建后恢复，通常说明旧缓存或缓存参数没有更新 |
| 缩略图能显示但模糊 | 检查内嵌缩略图和缓存尺寸 | 调整后执行 Rebuild thumbnails，不能只改显示大小 |
- 新建一个本地测试文件夹，放入一张能正常打开的 JPEG 和一张 PNG。
- 在 XnView MP 中打开该文件夹，确认浏览器视图是否显示缩略图。
- 如果测试文件正常，复制一份出现问题的文件进行对照，不要直接移动或覆盖原文件。
- 记录问题范围：全部目录、单个目录、某种格式，还是只有网络共享目录。
- 只有在完成设置和缓存检查后，才考虑恢复默认设置或重新安装。
缩略图空白：检查显示状态、过滤条件和缓存
先确认当前窗口确实处于显示缩略图的浏览器视图，而不是列表、详细信息或被过滤后的空目录。不同版本的中文菜单名称可能略有区别，下面同时列出常见英文菜单名；如果菜单位置不同，应以当前版本界面为准。
1. 检查缩略图相关设置
打开设置，查找 Settings > Thumbnails 或类似的缩略图设置，确认没有关闭缩略图显示，也没有启用只显示某类文件的过滤条件。对于 JPEG 等带有内嵌缩略图的文件，还要留意 Use embedded thumbnails 和 Create from original image if embedded thumbnail is smaller than thumbnail size 等选项。
内嵌缩略图通常生成较快，但尺寸可能小于当前浏览器缩略图。公开论坛资料说明，修改相关选项后，已经存在的缓存不会自动全部改变，通常需要手动重建缩略图。XnView Software 论坛：缩略图来源与缓存说明
2. 检查 Catalog 缓存是否启用
在设置中查找 Settings > Catalog，确认缩略图缓存功能处于启用状态，并检查缓存尺寸设置是否合理。缓存关闭时，程序可能每次重新生成缩略图；缓存参数变化后，旧缓存也可能继续被读取。
3. 重建当前目录的缩略图
- 在浏览器中选中出现问题的文件，或进入对应目录。
- 打开 Browser > View > Rebuild thumbnails，等待当前目录处理结束。
- 如果需要对更大范围处理，再到 Settings > Catalog 中查找重建缩略图功能。
- 关闭并重新打开目录，观察缩略图是否出现。
论坛资料明确列出了从 Browser > View 和 Settings > Catalog 重建缩略图的路径。XnView Software 论坛：重新扫描目录和更新缩略图缓存
只有部分文件不显示：按格式、路径和存储位置分流
某一种图片格式不显示
先用标准 JPEG 或 PNG 进行对照。如果标准格式正常，而 HEIC、AVIF、RAW 或其他格式异常，应在官方格式列表中核对该扩展名的读取支持，再确认当前 XnView MP 版本是否较旧。官方 FAQ 说明，XnView MP 支持多种新格式和常见 RAW 格式，但较新的相机型号可能需要更新到较新版本。官方 FAQ：格式与版本说明
不要把“原图能打开”直接等同于“缩略图一定能生成”。缩略图可能使用内嵌预览、缓存或重新读取原图，三者的处理结果可能不同。
只有网络共享目录、移动硬盘或只读介质异常
将少量文件复制到本机磁盘的短路径中测试。若本地目录能生成缩略图，问题范围就缩小到原目录的访问权限、连接状态、只读属性、路径长度或安全软件拦截等因素。此时不要先删除原目录缓存，先记录文件位置、账号权限和复现步骤。
只有视频文件没有缩略图
视频缩略图与静态图片不是同一条处理路径。公开论坛资料提到，视频缩略图还需要检查文件列表中的视频缩略图选项；启用后可能需要先切换到其他目录，再返回原目录观察。该设置名称和位置可能随版本变化，因此应以当前版本的 Settings、File list 或 Custom filter 页面为准。XnView Software 论坛：视频文件缩略图排查
缓存清理、升级和重装：推荐顺序
- 先重建：对当前目录执行 Rebuild thumbnails，确认是否只是旧缓存没有更新。
- 再清理对应缓存：如果重建无效，在 Catalog 的维护区域查找按目录删除或清理缩略图缓存的功能；清理前先确认不会误删原图和重要目录数据库。
- 再恢复设置：如果所有目录都异常，可记录当前版本、操作系统、缩略图设置和复现目录，再尝试恢复默认设置。
- 最后升级或重装：从可核验的软件来源获取当前版本，并先备份设置和目录数据库。官方 FAQ 说明，XnView MP 的设置和目录数据位于不同系统的用户配置目录，迁移或处理前应先确认路径。官方 FAQ：设置和目录数据位置
如果问题只发生在某种格式或某个目录，重装通常不是第一步。提交反馈时，建议附上版本号、操作系统、文件扩展名、是否能单图打开、测试目录结果和重建缓存后的变化，但不要上传包含隐私的原图或完整目录信息。
什么时候可以停止排查
满足以下任一条件，就可以先停止继续修改设置：一是标准 JPEG/PNG 在本地目录正常显示，说明程序基本功能可用，应转向检查异常文件或原目录；二是重建当前目录后恢复，说明问题主要与缓存有关；三是只有单一格式异常且官方资料无法确认当前版本支持，此时应记录版本和样本文件，改为核验格式兼容性；四是涉及企业共享目录或受管设备，优先遵守管理员策略，不要自行关闭安全软件或修改系统权限。
如果仍无法定位，保留最小复现目录和排查记录，比反复清理全部缓存更容易判断问题来源。
常见问题
XnView MP 能打开原图，但为什么不显示缩略图？
原图打开和缩略图生成可能使用不同路径。先用 JPEG、PNG 和本地短路径测试，再检查缩略图显示、内嵌缩略图、Catalog 缓存和当前目录重建功能。
修改缩略图大小后，为什么画面还是空白或很模糊？
旧缓存可能仍在被读取。调整 Settings > Thumbnails 或 Settings > Catalog 后，执行 Browser > View > Rebuild thumbnails，必要时再重新打开目录。
XnView MP 缩略图缓存可以直接删除吗？
建议先按目录处理，并确认已记录当前设置和目录数据位置。不要把原图目录、标签信息或目录数据库当作普通缓存直接删除；具体清理范围以当前版本的 Catalog 维护选项为准。
只有网络共享文件夹不显示缩略图怎么办？
先复制少量文件到本机短路径测试。本地正常而共享目录异常时，重点核对访问权限、连接状态、只读属性、路径和安全策略，不要先判断为程序损坏。
缩略图不显示时要不要马上重装？
不建议。先检查显示设置、过滤条件和缓存，再用标准 JPEG/PNG 做对照；只有全部目录持续异常且恢复默认设置或升级仍无效时，才考虑重装。