需安装启用Image Preview插件、规范图片路径格式、开启VSCode悬停功能、确保正确打开项目文件夹、排查冲突插件。
如果您在VSCode中编写Markdown或HTML文档时，希望将鼠标悬停在图片路径上即可即时查看图片内容，则可能是由于Image Preview插件未正确启用或配置。以下是实现悬停预览图片的多种操作方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用Image Preview插件
该插件需先从VSCode扩展市场下载并激活，才能提供悬停预览功能。未安装时，所有图片路径均无法触发预览行为。
1、打开VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入Image Preview，找到作者为SimonSiefke的插件。
3、点击“安装”按钮，安装完成后点击“重新加载”或手动重启VSCode。
二、验证图片路径格式是否符合插件识别规则
Image Preview仅对符合标准相对路径或绝对路径语法的图片引用生效，不支持URL编码异常、空格未转义或协议头缺失的情况。
1、确保Markdown中使用标准语法： 或 。
2、避免路径中出现未编码的空格，如./my image.jpg应改为./my%20image.jpg或重命名文件。
3、检查路径是否以./、../或/开头；纯文件名如logo.png默认不被识别。
三、调整VSCode设置以启用悬停预览
即使插件已安装，VSCode默认可能禁用悬停提示，需手动开启语言特性支持与悬停功能开关。
将选定的 Obsidian 笔记发布为静态站点并部署到 Cloudflare Pages。
1、按下Cmd + ,打开设置界面，在搜索框中输入editor.hover.enabled，确认其值为true。
2、继续搜索markdown.preview.imagePreview，确保该设置存在且未被覆盖；若无此项，说明插件未注册成功，需重装。
3、在设置JSON中手动添加（如需）："image-preview.enableHover": true。
四、检查工作区文件结构与根目录设定
插件解析路径依赖当前打开的文件夹作为根路径，若以单个文件方式打开（未打开文件夹），相对路径将无法解析。
1、关闭当前文件，选择菜单栏File > Open Folder…，选择包含图片资源的整个项目文件夹。
2、确认图片实际存放位置与Markdown中引用路径一致，例如./img/screenshot.png对应文件系统中项目根目录/img/screenshot.png。
3、在资源管理器中右键点击图片文件，选择“复制路径”，粘贴至Markdown中对比是否完全匹配。
五、禁用冲突插件以排除干扰
部分图像处理类插件（如Paste Image、Auto Rename Tag）可能劫持鼠标悬停事件或覆盖hover provider，导致预览失效。
1、打开命令面板（Cmd + Shift + P），输入并选择Extensions: Show Enabled Extensions。
2、逐个禁用名称含image、preview、hover的插件，每次禁用后保存并测试悬停效果。
3、若恢复预览，说明该插件与Image Preview存在兼容性问题，需保留其禁用状态或查阅对应插件文档中的冲突说明。
