QuickLook 按空格没反应？快速定位预览安装与位数问题的排查步骤

QuickLook 按空格没反应快速定位预览安装与位数问题的排查步骤【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook装了 QuickLook 却按空格没有预览窗口弹出来或者只有部分文件能预览这类安装问题大多卡在两个地方进程位数和它要调用的动态库没对上以及插件目录没被扫到。先别慌根因基本都能在几个真实文件里翻出来不用去啃安装日志。读完你能带走判断当前进程是 32 位、64 位还是 ARM64 的依据位数是如何决定加载哪一个动态库的插件加载失败时去哪看、怎么复现便携版与安装版的目录差异以及一个能落地的排查顺序确认预览失败卡在哪一步现象比日志更省钱。按空格之后大致是三种结果先确认你落在哪一类完全无反应焦点窗口检测或预览进程没起来多半是位数、动态库的问题。有窗口但不显示内容主程序起来了是插件没加载或格式不被识别。只有某些文件能预览某个具体插件图片、视频之类没被扫到。对上号之后再去看对应那一类的根因别一上来就重装。运行时按位数选动态库的判定逻辑核心机制一句话主程序启动时用App.Is64Bit和App.IsArm64决定去调哪个原生动态库DLL运行时被调用的二进制模块。这段逻辑在 QuickLook/NativeMethods/QuickLook.cs 里它同时声明了三个入口QuickLook.Native32.dll、QuickLook.Native64.dll、QuickLook.NativeArm64.dll。判断顺序是先问是不是 ARM64再看Environment.Is64BitProcess都不是才落到 32 位。也就是说位数错配时它不会报错而是静默走错分支表现就是预览异常。同样一个包在不同机器上行为不一致多半不是包的问题而是这台机器的进程位数在起作用。三步排查从位数到插件目录确认进程位数。看托盘菜单或日志里的位数标识32 位进程只会去调 Native32 动态库。位数对不上重装也白搭。核对原生动态库是否齐全。三个.dll必须在安装目录里都存在且位数匹配缺一个对应平台就失效。查插件加载。插件从两个目录扫描安装目录下的QuickLook.Plugin\和用户数据目录里的同名目录见 QuickLook/PluginManager.cs。加载失败会弹部分插件加载失败的提示并写日志把失败的文件名拿出来对照第 1、2 步即可定位。常见坑点对照表 ⚠️现象根因修复完全无预览进程位数与动态库不匹配核对位数用匹配平台的包重装部分格式无预览单个插件 DLL 位数不符或被系统拦截看失败提示替换对应插件便携版插件打不开Windows 安全策略拦截了程序集按提示解除拦截或改用安装版升级后行为异常旧安装目录残留彻底卸载、清残留再装便携版与自定义目录配置位置 普通安装版的用户数据落在%APPDATA%\pooi.moe\QuickLook\便携版则改放到可执行文件旁边的UserData\这一切换由 QuickLook.Common/Helpers/SettingHelper.cs 里的portable.lock文件触发程序目录里只要有这个锁文件就当便携模式跑配置和插件跟着一起挪位置。安装侧由 QuickLook.Installer/Product.wxs 描述按用户安装写一条HKCU\Software\QuickLook注册表项Windows 存配置的系统数据库作为已安装标记并建桌面与开始菜单快捷方式。想自定义安装目录时避开中文和空格不同位数版本建议放不同文件夹减少混装踩坑。分角色排查建议普通用户先看位数、再看安装目录九成问题到此为止。进阶用户顺手记住portable.lock和两个插件目录就能自己复现加载失败。维护者优先看 QuickLook/NativeMethods/QuickLook.cs 的位数分支再回头核对打包输出。【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考