Windows 10/11 的 HEIC 缩略图不显示windows-heic-thumbnails 帮你 5 分钟恢复照片预览【免费下载链接】windows-heic-thumbnailsEnable Windows Explorer to display thumbnails for HEIC/HEIF files项目地址: https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnailsiPhone 拍的照片拷进 WindowsHEIC 文件却全变成空白图标这是不少人的日常痛点。windows-heic-thumbnails 正是为此而生的开源 Shell 扩展它让 Windows 资源管理器直接渲染 HEIC 缩略图免费、离线、无捆绑装上就能用。一、HEIC 缩略图为何消失先纠正三个反常识的认知在动手之前我们得先搞明白看不见到底是谁的锅。第一个反常识HEIC 并不是小众格式而是 iPhone 的默认照片格式和 JPEG 相比同等画质下体积大约只有一半——正因为它优秀苹果才把它设为默认。第二个反常识Windows 不是技术上做不到而是不想免费做。HEIC 依赖 HEVCH.265编码涉及专利授权费用微软选择把解码能力放进商店的付费扩展里系统默认自然就不理会这些文件。第三个反常识最容易被忽略显示缩略图不等于能打开文件。这个项目只负责缩略图渲染双击打开或编辑 HEIC你仍然需要其他看图软件。把这三件事想清楚后面所有步骤都会变得顺理成章。二、免费方案那么多为什么推荐这个开源组件遇到同样问题的人通常会尝试三种做法。第一种是装第三方看图软件确实能打开 HEIC但资源管理器里的缩略图依旧是空白软件本身还可能捆绑弹窗和广告。第二种是去微软商店买 HEVC 解码扩展先不说要花钱它高度依赖商店环境、账户和网络离线或内网环境基本没戏而且是一个看不清内部逻辑的黑盒。第三种就是本项目它把缩略图这一件事做成一个 COM 组件挂在 .heic 文件类型的 Shell 扩展槽位上资源管理器按需调用注册即生效。它的优势很实在代码完全开源可以逐行审计注册表只写当前用户HKCU不碰系统级配置卸载干净运行时只需要三个 DLL几乎不占资源。对在意隐私、需要离线部署或想自己动手研究的人来说这是目前最可控的路线。三、安装前三个前置检查缺一个都可能白忙一场多数装完没反应的案例问题其实出在安装之前。第一确认系统是 64 位 Windows 10 或 11项目按 x64 构建32 位系统装不上。第二也是最容易踩的坑安装最新版 Microsoft Visual C Redistributablex64。这个运行库没装好DLL 根本加载不起来表现就是注册成功但毫无效果。第三三个文件必须待在同一文件夹HEICThumbnailHandler.dll 是外壳扩展本体heif.dll 是 libheif 解码库libde265.dll 负责 HEVC 解码。它们靠相对路径互相寻找拆开放、单独移动任何一个都会直接失效。四、安装实操一条注册命令加一次重启缩略图就回来了前置检查通过后真正的安装不到一分钟。第一步从 Release 页面下载最新版压缩包把三个 DLL 解压到一个固定的新建文件夹比如 C:\HEICThumbnails之后别乱动这个目录。第二步在该文件夹里打开终端执行regsvr32 HEICThumbnailHandler.dll。这行命令会向系统注册 COM 组件往 HKCU 写入几条注册表键把组件登记为 .heic 文件的缩略图处理器。第三步重启资源管理器——最简单的方式是打开任务管理器右键 explorer.exe 选择重新启动或者注销重登。 一个容易被忽略的细节项目注册时会主动通知系统刷新缩略图缓存内部调用 SHChangeNotify。如果你在安装前打开过含 HEIC 的文件夹资源管理器可能缓存了空白缩略图这个通知能确保旧缓存被清理避免你误以为没装成功。首次浏览含大量 HEIC 的文件夹会有短暂延迟那是系统在生成缩略图缓存第二次打开就是秒开。五、装完还是不行三个高频疑问的自查清单如果按上面步骤操作后依然没有缩略图先别急着重装对照这份清单排查。Q注册成功了图标还是空白先确认资源管理器真的重启过再检查三个 DLL 是否还在同一个目录、有没有被安全软件拦掉最后用看图软件打开那张 HEIC确认文件本身没有损坏。如果文件在传输过程中被截断任何插件都救不回来。Q它会不会修改我的照片完全不会。它通过 IInitializeWithStream 拿到文件流的只读访问解码完就释放绝不写回原文件。想卸载也很简单执行regsvr32 /u HEICThumbnailHandler.dll所有注册表痕迹一并清除。Q想排查得更细怎么办日志会写到 %LOCALAPPDATA%\HEICThumbProvider.log记录每个文件的解码和缩放过程。默认级别记录的信息有限如果你愿意动手可以在注册表 HKCU\Software\Classes\CLSID{2c93d534-2a1f-40d2-a375-babc92996987} 下新建一个名为 LogLevel 的 DWORD 值0 到 4数字越大记录越详细保存后重启资源管理器即可。 再补充一个容易被忽略的边界目前注册表挂钩的是 .heic 扩展名如果你手上有 .heif 后缀的文件需要自行在注册表里复制一份同样的 Shell 扩展配置才能生效。六、进阶玩法自己编译顺手给 DLL 瘦身 5MB对技术爱好者来说这个项目也是学习 Windows Shell 扩展的好教材。源码结构很清晰HEICThumbnailHandler.cpp 是核心实现了 IThumbnailProvider 接口并完成解码与缩放dllmain.cpp 负责 COM 注册、生命周期和引用计数log.cpp 是上面提到的日志模块。有两个实现细节很值得留意。其一它解码前会先尝试读取 HEIF 文件内嵌的小尺寸缩略图读不到才做完整解码再等比缩放——这正是它大多数情况飞快的原因。其二它同时实现 IInitializeWithStream让缩略图生成可以在隔离进程中运行即便某个损坏文件导致解码崩溃也不会拖垮整个资源管理器最多是那一张图不出缩略图。自己编译也不难克隆源码git clone https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails用 Visual Studio 2022 打开 src 下的解决方案文件依赖通过 vcpkg 安装 libheif 即可。项目还贴心准备了一个 vcpkg overlay 端口它会关闭 libheif 里用不到的 x265 编码器大约能省下一个 5MB 的 DLL。缩略图插件只需要解码编码器纯属多余——轻量就是这么一点点抠出来的。现在就可以做的四件事如果你已经受够了空白图标接下来的五分钟足够改变体验装好 VC 运行库下载三个 DLL 放进同一目录执行 regsvr32 注册重启资源管理器。完成后打开存有 iPhone 照片的文件夹你会看到久违的真实预览。想要更深一层掌控就去克隆源码自己编译顺便体验一把给 DLL 瘦身的乐趣。这个项目最打动人的地方在于它只做一件小事却把这一件事做到了极致——而日常使用中往往是这些小而准的工具最能让工作顺畅起来。【免费下载链接】windows-heic-thumbnailsEnable Windows Explorer to display thumbnails for HEIC/HEIF files项目地址: https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Windows 10/11 的 HEIC 缩略图不显示windows-heic-thumbnails 帮你 5 分钟恢复照片预览【免费下载链接】windows-heic-thumbnailsEnable Windows Explorer to display thumbnails for HEIC/HEIF files项目地址: https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnailsiPhone 拍的照片拷进 WindowsHEIC 文件却全变成空白图标这是不少人的日常痛点。windows-heic-thumbnails 正是为此而生的开源 Shell 扩展它让 Windows 资源管理器直接渲染 HEIC 缩略图免费、离线、无捆绑装上就能用。一、HEIC 缩略图为何消失先纠正三个反常识的认知在动手之前我们得先搞明白看不见到底是谁的锅。第一个反常识HEIC 并不是小众格式而是 iPhone 的默认照片格式和 JPEG 相比同等画质下体积大约只有一半——正因为它优秀苹果才把它设为默认。第二个反常识Windows 不是技术上做不到而是不想免费做。HEIC 依赖 HEVCH.265编码涉及专利授权费用微软选择把解码能力放进商店的付费扩展里系统默认自然就不理会这些文件。第三个反常识最容易被忽略显示缩略图不等于能打开文件。这个项目只负责缩略图渲染双击打开或编辑 HEIC你仍然需要其他看图软件。把这三件事想清楚后面所有步骤都会变得顺理成章。二、免费方案那么多为什么推荐这个开源组件遇到同样问题的人通常会尝试三种做法。第一种是装第三方看图软件确实能打开 HEIC但资源管理器里的缩略图依旧是空白软件本身还可能捆绑弹窗和广告。第二种是去微软商店买 HEVC 解码扩展先不说要花钱它高度依赖商店环境、账户和网络离线或内网环境基本没戏而且是一个看不清内部逻辑的黑盒。第三种就是本项目它把缩略图这一件事做成一个 COM 组件挂在 .heic 文件类型的 Shell 扩展槽位上资源管理器按需调用注册即生效。它的优势很实在代码完全开源可以逐行审计注册表只写当前用户HKCU不碰系统级配置卸载干净运行时只需要三个 DLL几乎不占资源。对在意隐私、需要离线部署或想自己动手研究的人来说这是目前最可控的路线。三、安装前三个前置检查缺一个都可能白忙一场多数装完没反应的案例问题其实出在安装之前。第一确认系统是 64 位 Windows 10 或 11项目按 x64 构建32 位系统装不上。第二也是最容易踩的坑安装最新版 Microsoft Visual C Redistributablex64。这个运行库没装好DLL 根本加载不起来表现就是注册成功但毫无效果。第三三个文件必须待在同一文件夹HEICThumbnailHandler.dll 是外壳扩展本体heif.dll 是 libheif 解码库libde265.dll 负责 HEVC 解码。它们靠相对路径互相寻找拆开放、单独移动任何一个都会直接失效。四、安装实操一条注册命令加一次重启缩略图就回来了前置检查通过后真正的安装不到一分钟。第一步从 Release 页面下载最新版压缩包把三个 DLL 解压到一个固定的新建文件夹比如 C:\HEICThumbnails之后别乱动这个目录。第二步在该文件夹里打开终端执行regsvr32 HEICThumbnailHandler.dll。这行命令会向系统注册 COM 组件往 HKCU 写入几条注册表键把组件登记为 .heic 文件的缩略图处理器。第三步重启资源管理器——最简单的方式是打开任务管理器右键 explorer.exe 选择重新启动或者注销重登。 一个容易被忽略的细节项目注册时会主动通知系统刷新缩略图缓存内部调用 SHChangeNotify。如果你在安装前打开过含 HEIC 的文件夹资源管理器可能缓存了空白缩略图这个通知能确保旧缓存被清理避免你误以为没装成功。首次浏览含大量 HEIC 的文件夹会有短暂延迟那是系统在生成缩略图缓存第二次打开就是秒开。五、装完还是不行三个高频疑问的自查清单如果按上面步骤操作后依然没有缩略图先别急着重装对照这份清单排查。Q注册成功了图标还是空白先确认资源管理器真的重启过再检查三个 DLL 是否还在同一个目录、有没有被安全软件拦掉最后用看图软件打开那张 HEIC确认文件本身没有损坏。如果文件在传输过程中被截断任何插件都救不回来。Q它会不会修改我的照片完全不会。它通过 IInitializeWithStream 拿到文件流的只读访问解码完就释放绝不写回原文件。想卸载也很简单执行regsvr32 /u HEICThumbnailHandler.dll所有注册表痕迹一并清除。Q想排查得更细怎么办日志会写到 %LOCALAPPDATA%\HEICThumbProvider.log记录每个文件的解码和缩放过程。默认级别记录的信息有限如果你愿意动手可以在注册表 HKCU\Software\Classes\CLSID{2c93d534-2a1f-40d2-a375-babc92996987} 下新建一个名为 LogLevel 的 DWORD 值0 到 4数字越大记录越详细保存后重启资源管理器即可。 再补充一个容易被忽略的边界目前注册表挂钩的是 .heic 扩展名如果你手上有 .heif 后缀的文件需要自行在注册表里复制一份同样的 Shell 扩展配置才能生效。六、进阶玩法自己编译顺手给 DLL 瘦身 5MB对技术爱好者来说这个项目也是学习 Windows Shell 扩展的好教材。源码结构很清晰HEICThumbnailHandler.cpp 是核心实现了 IThumbnailProvider 接口并完成解码与缩放dllmain.cpp 负责 COM 注册、生命周期和引用计数log.cpp 是上面提到的日志模块。有两个实现细节很值得留意。其一它解码前会先尝试读取 HEIF 文件内嵌的小尺寸缩略图读不到才做完整解码再等比缩放——这正是它大多数情况飞快的原因。其二它同时实现 IInitializeWithStream让缩略图生成可以在隔离进程中运行即便某个损坏文件导致解码崩溃也不会拖垮整个资源管理器最多是那一张图不出缩略图。自己编译也不难克隆源码git clone https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails用 Visual Studio 2022 打开 src 下的解决方案文件依赖通过 vcpkg 安装 libheif 即可。项目还贴心准备了一个 vcpkg overlay 端口它会关闭 libheif 里用不到的 x265 编码器大约能省下一个 5MB 的 DLL。缩略图插件只需要解码编码器纯属多余——轻量就是这么一点点抠出来的。现在就可以做的四件事如果你已经受够了空白图标接下来的五分钟足够改变体验装好 VC 运行库下载三个 DLL 放进同一目录执行 regsvr32 注册重启资源管理器。完成后打开存有 iPhone 照片的文件夹你会看到久违的真实预览。想要更深一层掌控就去克隆源码自己编译顺便体验一把给 DLL 瘦身的乐趣。这个项目最打动人的地方在于它只做一件小事却把这一件事做到了极致——而日常使用中往往是这些小而准的工具最能让工作顺畅起来。【免费下载链接】windows-heic-thumbnailsEnable Windows Explorer to display thumbnails for HEIC/HEIF files项目地址: https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
