双击图片只显示乱码,需右键标签页选择Reopen with Editor→Image Preview启用内置预览;若菜单无此选项,则VSCode版本低于1.80或后缀不被支持;悬停预览须安装Image Preview插件并确保workbench.hover.enabled、editor.hover.enabled和image-preview.enableHoverPreview均为true,且路径为静态合法格式。

双击图片只显示乱码?先切编辑器模式
VSCode 默认把图片当二进制文件打开,所以双击看到的是十六进制乱码或空白页——这不是插件没装好,是它根本没启用图片渲染模式。解决方法极简:右键标签页 → Reopen with Editor → Image Preview。成功后缩略图就出来了,标题栏会显示photo.jpg (Preview)。
注意:如果菜单里没有Image Preview选项,说明当前 VSCode 版本低于 1.80,或文件后缀未被识别(比如.avif、.tiff不支持);.svg虽能预览,但渲染为位图,不执行 JS,也不读width/height属性。
想悬停就看图?三个设置必须为 true
内置预览只管“打开文件”,悬停预览完全依赖Image Preview插件(作者 Krzysztof Dziendziel,图标是眼睛),且极易因配置错位失效。安装后必须确认以下三项均为true:
workbench.hover.enablededitor.hover.enabledimage-preview.enableHoverPreview
路径必须是静态字符串,以./或../开头,写成"./assets/logo.png"才有效;assets/logo.png(缺引号)、require('./icon.png')(变量拼接)、https://(网络地址)全都不触发。光标要落在路径字符内部(比如logo.png的l上),停在引号或空格上无效。
预览窗口不显示宽高?插件解析头信息才准
VSCode 内置预览只渲染图像,不读IHDR(PNG)或SOF0(JPEG)等头部数据,所以标题栏和悬停提示里永远没有1920×1080或2.1 MB。要看到真实像素尺寸和文件大小,必须用vscode-image-preview(作者 yudai)这类前端解析插件——它直接读图像头,不调外部命令,离线可用。
安装后,右键资源管理器中的图片 → Open Preview,标题栏立刻显示icon.png (48×48, 3.2 KB);在 Markdown 中悬停也会弹出带尺寸的浮层。注意:它不支持.bmp、未压缩.tiff,也不处理 Base64 字符串。
大图卡顿或 SVG 失真?别硬扛,换终端查
插件预览大图(比如 100MB TIFF)可能卡死,SVG 缩放又容易模糊裁剪——这时最稳的方案是终端一行命令:
file path/to/image.jpg(macOS/Linux 自带,Windows 需 Git for Windows 或 WSL)
输出含1920x1080;更精确可装 ImageMagick 后运行:identify -format "%wx%h" path\to\image.png。注意:file只读头部,安全快;identify会解码整图,慎用于超大文件。
真正麻烦的是 JS 动态生成尺寸的 SVG:VSCode 预览完全不执行脚本,此时只能靠浏览器调试——这点容易被忽略,但没法绕过。


















