VSCode的Image preview插件:悬停即可预览图片

22次阅读

需安装启用Image Preview插件、验证路径格式合法、开启悬停预览设置、排除插件冲突,并可手动触发预览验证功能。

VSCode的Image preview插件:悬停即可预览图片

如果您在vscode中编辑markdown或代码文件时,希望将鼠标悬停在图片路径上即可即时查看图片内容,则可能是由于Image Preview插件未启用或配置异常。以下是实现该功能的多种方法:

本文运行环境:macBook air,macOS Sequoia。

一、安装并启用Image Preview插件

Image Preview是VSCode中广泛使用的轻量级插件,支持在悬停时解析相对路径与绝对路径的图片资源,并以浮动面板形式渲染预览图。需确保插件已正确安装且处于启用状态。

1、打开VSCode,点击左侧活动栏的扩展图标(或按快捷键Cmd+Shift+X)。

2、在扩展搜索框中输入Image Preview,找到作者为Krzysztof Dziendziel的插件。

3、点击Install按钮完成安装,安装完成后点击Reload或重启VSCode。

二、验证图片路径格式是否符合插件识别规则

Image Preview仅识别标准的Markdown图片语法和部分html img标签中的src属性,且要求路径可被VSCode工作区上下文解析。不支持动态拼接路径或未保存的临时路径。

1、确保图片引用采用合法Markdown语法:![alt text](./images/photo.png)

2、检查路径是否为相对路径且位于当前工作区目录内,例如./assets/logo.jpg../resources/icon.svg

3、避免使用变量、模板字符串css background-image等非直接引用方式,插件无法解析此类内容。

三、检查VSCode设置中是否禁用了悬停预览功能

VSCode全局或工作区设置可能覆盖插件默认行为,导致悬停事件不触发预览面板。需确认相关设置项处于开启状态。

1、按下Cmd+,打开设置界面,在搜索框中输入image preview hover

2、确认选项Image Preview: Enable Hover Preview已被勾选。

3、若使用jsON设置文件,检查"image-preview.enableHoverPreview"值是否为true

四、排除与其他插件的冲突

部分Markdown增强类插件(如Markdown All in One、Paste Image)会劫持hover事件或重写图片解析逻辑,从而抑制Image Preview的响应。

1、进入扩展视图,依次禁用近期安装的Markdown或图像处理类插件。

2、重启VSCode后,在任意含图片路径的文件中悬停测试,确认预览是否恢复。

3、若恢复正常,逐个重新启用被禁用插件,定位引发冲突的具体插件名称。

五、手动触发预览作为替代操作

当悬停失效但插件功能正常时,可通过命令面板调用预览命令,验证插件核心能力是否可用。

1、将光标置于图片路径字符串内部(如photo.png所在位置)。

2、按下Cmd+Shift+P打开命令面板,输入Image Preview: Show Preview

3、回车执行,预览窗口将在编辑器右侧弹出,显示对应图片内容。

text=ZqhQzanResources