需依次启用缩略图服务、修复thumbnailer状态、设“看图”或Okular为默认程序、检查SELinux/AppArmor拦截。具体包括:一、在文件管理器设置中勾选“显示本地磁盘缩略图”与“显示远程环境缩略图”;二、执行systemctl --user status thumbnailer确认服务运行,若异常则启动并设为开机自启,清除缓存;三、在控制中心“默认程序”中将“看图”设为图片默认程序、“Okular”设为PDF默认程序;四、若Okular无效,手动创建okular.thumbnailer文件并重启服务。

统信UOS文件管理器中图片、PDF等文件显示空白缩略图,或双击后预览窗口无响应,说明缩略图服务未启用、远程目录限制未解除,或默认查看程序未正确绑定,需分阶段排查修复。
启用本地与远程目录的缩略图预览功能
文件管理器默认禁用远程挂载目录(如SMB/NFS方式挂载的NAS)的缩略图生成,部分版本对NTFS/FAT32本地分区也存在抑制策略,必须手动开启全局支持。
1、打开文件管理器,点击右上角菜单按钮(三个点),选择“设置”。
2、在设置窗口左侧边栏中,依次展开“工作区”→“缩略图预览”选项卡。
3、勾选“显示本地磁盘缩略图”与“显示远程环境缩略图”两个复选框。
4、若选项不可见,请先前往“控制中心”→“系统更新”,确认系统版本不低于22.0 SP3;如已为最新版,执行命令:sudo systemctl restart dde-file-manager重启服务。
5、返回对应目录,右键单击空白处,选择“刷新”,等待缩略图批量生成完成。
检查并修复缩略图缓存服务状态
缩略图依赖独立的thumbnailer服务进程,该服务异常退出或被系统清理,将导致所有预览功能失效,包括图片、PDF、文本等格式的内嵌预览。
方法一:终端快速诊断与启动
1、按Ctrl+Alt+T打开终端,输入命令:systemctl --user status thumbnailer,确认服务状态为active (running)。
2、若显示inactive或failed,执行:systemctl --user start thumbnailer启动服务。
3、设为开机自启:systemctl --user enable thumbnailer。
4、清除旧缓存以强制重建:rm -rf ~/.cache/thumbnails/*。
5、重新进入文件管理器,任意目录中等待数秒,观察缩略图是否开始逐个生成。
方法二:补全缩略图框架(仅限精简版UOS)
若执行status命令提示not found,说明基础缩略图框架未安装:执行sudo apt install thumbnailer安装后再启动服务。
将“看图”或“文档查看器”设为默认预览程序
当系统未指定默认图片/文档处理应用时,双击操作可能调用空壳程序或直接跳过预览流程,必须显式绑定格式接管权限。
第一步:打开控制中心 → “默认程序” → 左侧点击“图片”。
第二步:右侧列表中,确保“看图”对JPEG/PNG/GIF等图像格式已被选中(前方出现蓝色选中标记)。
第三步:左侧点击“文档”,确保“文档查看器”对PDF/TXT/DOCX等格式已被选中。
第四步:关闭控制中心,立即在文件管理器中双击一张图片或PDF文件,验证预览窗口是否正常弹出。
针对PDF缩略图空白的专项修复
PDF缩略图长期空白,往往不是通用缩略图服务问题,而是当前绑定的thumbnailer后端不支持PDF解析,必须指定Okular作为专用处理器。
方法一:图形界面绑定
打开“控制中心” → “默认程序” → 找到“PDF文档”条目 → 点击右侧下拉箭头 → 选择“Okular”。
方法二:命令行强制绑定
在终端中执行:xdg-mime default org.kde.okular.desktop application/pdf;注意:.desktop后缀不可省略,且application/pdf前后不能有空格。
方法三:手动注册thumbnailer规则(仅当Okular已安装但缩略图仍为空白时)
1、创建缺失文件:sudo nano /usr/share/thumbnailers/okular.thumbnailer;
2、填入以下四行内容:
[Thumbnailer Entry]
TryExec=okular
Exec=okular --icon %u %i %o
MimeType=application/pdf
3、设置权限:sudo chmod 644 /usr/share/thumbnailers/okular.thumbnailer;权限必须为644,否则thumbnailer无法读取。
4、执行systemctl --user restart thumbnailer重启服务。

















