求助:VS Code中图片加载失败问题的解决方法
解决VS Code图片加载错误的排查方案
针对你遇到的VS Code图片无法显示、提示“加载图片时发生错误”的问题,以下是几个针对性的排查步骤,你可以逐一尝试:
核对图片路径与格式
- 检查图片路径是否正确,尤其是相对路径的层级(比如是否多写/少写了
../),Linux和macOS系统要注意路径大小写是否匹配 - 确认图片是VS Code支持的格式(jpg、png、webp等),如果是特殊格式(比如HEIC),可以先转成通用格式测试
- 临时把图片移到当前编辑文件的同目录,用
./xxx.png的路径引用,排除路径层级问题
- 检查图片路径是否正确,尤其是相对路径的层级(比如是否多写/少写了
重置VS Code配置
- 打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入
Preferences: Reset Settings,选择重置所有设置(记得先备份自己的自定义配置),重启后测试 - 也可以手动删除用户配置文件:
- Windows:
%APPDATA%\Code\User\settings.json - macOS:
~/Library/Application Support/Code/User/settings.json - Linux:
~/.config/Code/User/settings.json
备份后删除该文件,重启VS Code
- Windows:
- 打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入
排查扩展冲突
- 打开命令面板,输入
Extensions: Disable All Installed Extensions,禁用所有扩展后重启VS Code,看图片是否能正常显示 - 如果恢复正常,再逐个启用扩展,每次启用后重启测试,找到引发冲突的扩展,要么更新到最新版,要么直接卸载
- 打开命令面板,输入
检查图片预览相关设置
- 打开设置面板(Ctrl+, / Cmd+,),搜索
image preview,确保Editor: Image Preview选项处于启用状态 - 再搜索
Files: Associations,确认.png、.jpg等图片格式关联的是default或者VS Code自带的图片编辑器,不是第三方插件的编辑器
- 打开设置面板(Ctrl+, / Cmd+,),搜索
修复或重装VS Code
- Windows用户可以在控制面板找到VS Code,选择“修复”选项;macOS用户直接下载最新安装包覆盖安装
- 如果以上都无效,完全卸载VS Code(注意清理残留的配置文件夹),再重新下载安装最新版本
内容的提问来源于stack exchange,提问作者Arvin Buzon
相关产品推荐
相关产品推荐

