webstorm 默认不显示图片缩略图，需手动开启“image thumbnails”选项，且仅在编辑器tab和悬停tooltip中显示，svg、大尺寸图及webp支持有限，高dpi屏幕下可能出现渲染异常。
WebStorm 图片文件不显示缩略图预览
默认情况下 WebStorm 不会为图片文件（如 .png、.jpg、.svg）生成并显示缩略图，这不是 bug，而是设计如此——它优先保障大型项目下的性能和内存占用。缩略图预览需手动启用，且仅对部分格式生效。
- 确认已开启「Image Thumbnails」：进入
Settings / Preferences → Editor → General → Appearance，勾选Show image thumbnails in editor tabs and Project tool window -
.svg文件默认不生成缩略图（即使勾选了也无效），这是 JetBrains 的已知限制；若需预览，建议右键用外部工具打开，或安装插件SVG Viewer - 大尺寸图片（如 >5MB 或分辨率超 4096×4096）可能被跳过渲染，避免拖慢 UI；可临时缩小测试图验证是否为尺寸问题
- 确保图片路径无中文或特殊字符（如空格、
%、#），否则缩略图可能加载失败但无报错提示
Project 工具窗口中图片仍不显示预览图标
即使启用了缩略图，Project 树状视图里仍只显示通用文件图标（不是缩略图），这是正常行为。WebStorm 的「缩略图」只出现在两个位置：编辑器 Tab 标题右侧小图标、以及鼠标悬停在文件名上时的 tooltip 中——不是左侧文件列表里的内嵌预览。
- 悬停验证：把鼠标停在
icon.png上，1–2 秒后应弹出带缩略图的 tooltip；不出现则说明缩略图功能未生效 - 排除插件干扰：禁用第三方 UI 插件（如
Nord Theme、Material Theme UI），某些主题会覆盖 tooltip 样式导致缩略图不可见 - 重启 WebStorm 后首次加载缩略图有延迟，特别是含大量图片的目录；可先打开单个图片触发缓存初始化
缩略图模糊、拉伸或颜色异常
这是 Java AWT 渲染层对图像解码的副作用，尤其常见于高 DPI 屏幕（如 macOS Retina、Windows 缩放 125%+）。WebStorm 本身不控制像素级渲染质量，依赖底层 JDK 图像处理能力。
- 升级到 JetBrains Runtime 11+（WebStorm 2021.3 起默认内置），能显著改善 PNG/JPEG 解码保真度
- 避免使用
WebP：当前（截至 2024.2）WebStorm 对.webp的缩略图支持不稳定，常显示为灰色方块或直接不加载 - 检查系统环境变量
JBR_JAVA_OPTIONS是否设置了强制缩放（如-Dsun.java2d.uiScale=1.5），这会导致缩略图采样错乱
Open in External Tool 绑定到 Space 键，反而更可靠。
