需安装启用Image Preview插件、确保图片路径为静态标准格式、开启workbench.hover.enabled设置，并在多根工作区中配置image-preview.basePath以正确解析相对路径。
如果您在 vscode 中编辑 markdown 或 html 文件时，希望将鼠标悬停在图片路径上即可直接查看图像内容，但该功能未生效，则可能是由于插件未启用、配置缺失或路径解析异常。以下是实现此功能的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 Image Preview 插件
VSCode 本身不内置图片悬停预览能力，需依赖第三方扩展提供该功能。Image Preview 是一个轻量且广泛使用的插件，支持多种图片格式及相对/绝对路径解析。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在扩展搜索框中输入 Image Preview，找到作者为 Krzysztof Dziendziel 的插件。
3、点击“安装”按钮，安装完成后点击“重新加载”或手动重启 VSCode。
二、验证图片路径格式是否符合插件要求
Image Preview 仅对语法规范的图片引用路径触发悬停预览，不支持注释内路径、字符串拼接或变量插值等动态写法，必须为静态、可静态解析的路径字符串。
1、确保 Markdown 中使用标准语法：。
2、确保 HTML 中使用 <img src="./images/photo.jpg" /> 形式，且 src 属性值为双引号包裹的静态字符串。
3、避免路径中包含未转义的空格或中文字符；若必须使用，应确认文件实际保存编码与 VSCode 工作区编码一致（推荐 UTF-8）。
三、检查并配置 workbench.hover.enabled 设置
VSCode 全局悬停功能若被禁用，将导致所有扩展的悬停行为（包括 Image Preview）失效，需确保基础悬停能力处于开启状态。
1、按下 Cmd+, 打开设置界面。
2、在搜索框中输入 hover enabled。
3、勾选 Workbench > Hover: Enabled 选项。
四、调整插件路径解析范围（适用于多根工作区）
当工作区包含多个文件夹（Multi-root Workspace）时，Image Preview 默认仅基于当前打开文件所在文件夹解析相对路径，可能无法定位其他根目录下的图片资源。
1、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Open Settings (JSON)。
2、在 settings.json 中添加如下配置项：
"image-preview.basePath": "./" —— 指定基准路径为工作区根目录。
3、若图片分散在不同子目录，可设为 "image-preview.basePath": "${workspaceFolder}" 以启用各根文件夹独立解析。
