sublime text 不支持文件缩略图预览,所谓“侧边预览”实为 preview_on_click 的临时文本加载;它不渲染图片/pdf,无侧边栏缩略图api,也不识别 side_bar_thumbnail_size 等伪配置项。

Sublime Text 本身不支持文件缩略图(比如图片、PDF 的预览图),也没有内置的「侧边预览窗口」功能——所谓“缩略图”或“侧边预览”,基本都是用户误把 preview_on_click 行为当成了可视化预览,或者装了第三方插件后产生的错觉。
为什么搜“Sublime 缩略图”总跳到 preview_on_click?
因为很多人看到单击侧边栏后编辑区快速闪现一张图/一段代码,就以为是“缩略图预览”。其实那是 Sublime 原生的文件预览机制:临时加载、斜体标签、不保存、焦点一移就替换。它不是图形渲染,也不生成缩略图,更不会在侧边栏里开新窗显示小图。
- 预览行为只依赖
preview_on_click开关,和文件类型无关(哪怕打开的是icon.png,也只是以文本/二进制方式加载,不渲染图像) - 所有图片类文件(
.png、.jpg、.pdf)在 Sublime 中默认用十六进制或乱码显示,除非你装了专用插件 - 没有官方或主流插件能在侧边栏里嵌入真正意义上的缩略图窗口;所谓“侧边预览”,通常是 VS Code 或 Atom 用户记混了编辑器
想看图片/PDF 预览?得靠插件,但不在侧边栏
Sublime 支持通过插件实现外部程序调用式预览(比如用系统默认看图软件打开),或内联渲染(极少数插件尝试过,但稳定性和兼容性差)。注意:这些都不在侧边栏里出窗口,而是替换当前编辑区或新开系统窗口。
-
ImagePreviews插件:可让 PNG/JPG/GIF 在编辑区直接渲染成图(需重启生效),但仅限部分格式,且不支持缩略图列表 -
PDF Preview插件:双击 PDF 文件时调用系统 PDF 阅读器(如 Acrobat、Preview.app),不是内嵌预览 - 任何声称“侧边栏缩略图”的插件,大概率是伪造 UI(比如用文字+符号模拟方块)、已停止维护,或根本无法在 Sublime 4+ 正常运行
别被“侧边预览窗口”误导:Sublime 没这个 API
Sublime 的 API 不开放侧边栏区域的自定义渲染能力。插件能做的顶多是往侧边栏加右键菜单、修改文件图标、折叠/展开逻辑,但不能插入 HTML/CSS/Canvas 来画缩略图——这和 VS Code 的 Webview 或 JetBrains 系列的 UI 扩展机制有本质区别。
- 试图用 CSS hack 给侧边栏加背景图或伪元素模拟缩略图,会破坏文件名点击热区,且不同主题下极易错位
- 某些旧教程提到的
side_bar_preview配置项并不存在于任何 Sublime 版本中,是拼写混淆(实际只有preview_on_click) - 如果你真需要缩略图浏览,建议切换到 VS Code(配合
Image Preview插件)或专用工具(如 XnView、Electron-based 文件管理器)
真正要警惕的是那些教你在用户设置里加 "side_bar_thumbnail_size": 64 或类似字段的伪教程——Sublime 解析不了,静默忽略,还可能因 JSON 语法错误导致整个设置失效。缩略图不是开关问题,是底层能力缺失。











