麒麟os需启用tumblerd服务、切换图标视图并勾选预览、将maxfilesize设为50000000字节后重启服务并清空~/.cache/thumbnails/缓存,才能使图片、pdf及office文档正常显示缩略图和右侧预览。

麒麟OS文件管理器中图片、PDF、Office文档无法直接显示缩略图或右侧预览窗格空白,说明预览功能未正确启用或底层服务配置缺失,需从系统服务、视图模式、缓存策略三方面同步调整。
启用Tumbler缩略图生成服务
预览依赖后台服务tumblerd实时生成缩略图,服务未运行则所有预览功能完全失效。
按下Ctrl+Alt+T打开终端,执行systemctl --user status tumblerd检查状态。若显示inactive或failed,立即执行systemctl --user start tumblerd启动服务。
执行tumbler-thumbnailer -l确认输出中包含jpeg、png、pdf、docx等关键格式条目。缺失任意一类(如PDF),必须安装插件:sudo apt install tumbler-plugins-extra。
【注意:tumblerd是用户级服务,必须用--user参数操作,直接sudo systemctl start tumblerd无效】
在文件管理器中开启预览视图
即使服务正常,若视图模式不匹配,缩略图和预览窗格也不会出现。
打开任意文件夹,点击右上角四个方格图标→选择“图标视图”。列表视图和紧凑视图下缩略图强制禁用。
点击顶部菜单栏【查看】→【侧边栏】→勾选“预览”,右侧将立即出现实时内容预览区域,支持图片、文本、PDF等格式。
再进入【查看】→【详细信息栏】→勾选“显示”,底部会同步显示当前选中文件的尺寸、修改时间等元数据。
右键空白处→【排序方式】→选“按类型”或“按修改时间”,让同类文件集中排列,便于快速识别预览效果。
调整缩略图最大文件限制并清除缓存
默认MaxFileSize=10000000(10MB),导致高清图、大PDF、长Word文档被跳过生成——这是预览失败最隐蔽也最常见的原因。
第一步:创建用户配置目录
执行mkdir -p ~/.config/tumbler
第二步:复制默认配置
执行cp /etc/xdg/tumbler/tumbler.rc ~/.config/tumbler/
第三步:编辑配置文件
执行nano ~/.config/tumbler/tumbler.rc,定位[Thumbnailers]段落,将MaxFileSize=改为MaxFileSize=50000000(即50MB)。
【此值必须为纯数字,单位字节,不可带空格或字母,否则服务重启后报错退出】
第四步:保存退出,执行systemctl --user restart tumblerd重启服务。
第五步:清空旧缓存
执行rm -rf ~/.cache/thumbnails/*,彻底删除残留损坏记录。











