QuickLook 32/64位版本安装路径冲突：从诊断到修复的完整指南

【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook

QuickLook 把 macOS 上"空格预览文件"的体验带到了 Windows，让你不双击打开就能快速查看图片、视频、PDF 和压缩包。但不少人会撞上 QuickLook 安装路径冲突这个坑：同一份安装包，在这台电脑上预览正常，到了另一台电脑却毫无反应。这篇文章带你把从诊断到修复的完整过程走一遍，看完就能定位并解决。

为什么 32/64 位会打架：一条因果链

QuickLook 32位64位版本不匹配不是几个孤立的毛病，而是同一条因果链上炸开的：

• 原生组件由两个独立工程编译：QuickLook.Native32/ 面向 Win32，QuickLook.Native64/ 面向 x64，各产出对应位数的 DLL
• 两个工程的OutDir都指向$(SolutionDir)Build\$(Configuration)\，也就是说两种位数的编译产物默认会汇总到同一目录，文件混放是冲突的根源
• 安装器 Product.wxs 声明了Platform="x86"和InstallScope="perUser"，并在用户级注册表HKCU\Software\QuickLook写入安装标记

于是冲突就发生在两个层面：程序位数和系统位数对不上时，QuickLook.exe 加载对应 DLL 的那一刻就会失败，右键预览直接"没反应"；而旧位数的文件没清理干净时，输出目录和插件目录串味，插件加载失败就是这么来的。

快速自查清单：先判断症状属于哪一类

⚠️ 修之前先做三步定位，避免白忙：

1. 打开"设置 → 系统 → 关于"，记下"系统类型"是 64 位还是 32 位
2. 在 QuickLook 安装目录里查看 QuickLook.exe 的属性，确认它自身是哪种位数
3. 对照下面的症状归类

三种情形对照修复

情形一：装错了位数

程序位数必须跟系统位数对齐，所以这一步没有技巧：

1. 对照"系统类型"重新下载安装包
2. 安装完成后，在资源管理器里选中任意图片按空格键
3. 预览窗口弹出来，就说明主程序已经正常

情形二：清理插件残留

插件按位数去定位原生组件，残留的旧位数文件会直接让它找不到依赖：

1. 右键系统托盘图标，完全退出 QuickLook
2. 删除%LOCALAPPDATA%\QuickLook\Plugins下的残留内容
3. 重新安装与主程序位数一致的插件

情形三：自定义安装路径

WiX 安装器通过WixUI_InstallDir支持修改目标目录，默认根目录是ProgramFilesFolder（通常对应C:\Program Files）。手动改路径时记住三点：

• 路径里别放中文和空格
• 确认当前账号对该目录有读写权限
• 两种位数建议用不同目录名（如 QuickLook32 / QuickLook64），避免再次混放

切换与验证：一条流水线走完

换位数时按顺序走完这四步，才能保证干净：

1. 控制面板 → 程序和功能，卸载 QuickLook
2. 删除残留目录：C:\Program Files\QuickLook、%APPDATA%\QuickLook以及插件目录里的遗留文件
3. 安装正确位数的版本，保持默认路径
4. 验证：右键系统托盘图标确认版本信息，再随机预览几种不同格式的文件

如果你自己编译过源码，记住两个原生工程的输出都落在Build\下。打包含插件的包之前，先清空Build\，别让两种位数的文件混在一个目录里出厂。

两条收尾建议与延伸阅读

• 普通用户坚持默认路径，位数不对就"先卸载、再清理、后重装"，别在原目录上覆盖
• 自编译的开发者按位数分开清理输出目录，绝不跨目录手动挪文件

安装器的完整逻辑可以读 QuickLook.Installer/ 下的 WiX 配置；想确认原生组件的位数，分别查看 QuickLook.Native32/ 和 QuickLook.Native64/ 两个工程文件即可。

【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook