QuickLook 便携版使用指南一个 portable.lock 让 U 盘跑起完整预览【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook本文带你免安装使用 QuickLook 便携版在 exe 旁放一个portable.lock全部配置与用户插件就落进程序目录的UserData里拷到 U 盘或公共电脑上按空格即可预览。你还会学到插件双目录的分工以及 U 盘环境下最容易踩的 Windows「解除锁定」坑。它把 macOS 的「空格即览」带到 Windows在资源管理器中选中文件按 Space弹出独立预览窗无需启动重型应用、无需双击等进程启动。便携版与安装版有三处实质差异本文按「开关 → 目录 → 行为」的顺序拆解数据位置从系统目录%APPDATA%\pooi.moe\QuickLook\移到 exe 旁的UserData\用户插件来源从系统目录移到UserData\QuickLook.Plugin\安全处理插件被 Windows 拦截时自动触发解除阻塞逻辑这是便携模式独有的分支QuickLook 如何检测便携模式整个「是否便携」的判断由一个文件决定portable.lock放在可执行文件所在目录。判断逻辑在 QuickLook.Common/Helpers/SettingHelper.cs核心就两行var lck Path.Combine(exe所在目录, portable.lock); return File.Exists(lck);文件内容不重要纯「存在性检测」。程序据此选择数据目录运行模式配置与数据所在位置安装版无 portable.lock%APPDATA%\pooi.moe\QuickLook\便携版存在 portable.lockexe 同级的UserData\QuickLook/App.xaml.cs 把结果暴露为进程级字段IsPortable SettingHelper.IsPortableVersion()。README 的发行版对比表也印证了这一点Portable mode 仅在 Installer 与 Nightly 两种发行形式中可用Store 版是沙盒安装包、Scoop 是托管安装都带不动这个文件。组装便携目录的三步1. 拿全文件不必自己编译直接取 installer 版发布包即可如需从源码构建克隆仓库git clone https://gitcode.com/gh_mirrors/qu/QuickLook便携目录只需要三类东西QuickLook.exe及同目录依赖含QuickLook.Native原生库和各.dllQuickLook.Plugin\内置插件目录你接下来要创建的portable.lock缺了内置插件目录程序能启动但大部分格式没有预览器缺了原生库部分文件类型如缩略图相关功能会失效。2. 创建 portable.lock为什么必须手动建这个空文件是上面检测逻辑的唯一输入没有它就按安装版运行。资源管理器里新建文本文档 → 重命名为portable.lock。先打开「显示文件扩展名」否则实际文件名是portable.lock.txt或 PowerShell 一行New-Item .\portable.lock3. 首跑自检双击QuickLook.exe看两个信号exe 旁出现UserData\目录里面有QuickLook.config在资源管理器选中任意文件按 Space预览窗正常弹出如果第 1 点没出现先检查分区是否可写程序启动时会执行EnsureFolderWritable(LocalDataPath)检查失败直接退出——所以只读分区的 U 盘或受策略管控的目录跑不起来。UserData配置与用户插件的落点程序写入的内容全部收敛在UserData\下配置文件的命名规则见 OPTIONS.mdQuickLook.config主配置托盘图标、窗口透明度、渲染模式、更新开关等QuickLook.Plugin.xxx.config每个插件一份如QuickLook.Plugin.VideoViewer.configQuickLook.Plugin\用户插件的安装位置几个便携场景下值得改的选项DisableAutoUpdateCheckTrue/DisableAutoUpdateCheck关闭启动时的自动更新检查公共电脑上避免尝试拉取新版ProcessRenderMode1/ProcessRenderMode强制纯软件渲染应对老旧 GPU 或驱动异常ExtensionAllowlist/ExtensionBlocklist控制哪些扩展名参与预览安装版下这些文件在%APPDATA%便携版下全在UserData\。所以「备份配置」就是拷贝整个UserData文件夹「换机迁移」同理。插件双目录如何分工QuickLook/PluginManager.cs 的构造函数按固定顺序扫描两个目录用户插件App.UserPluginPath即UserData\QuickLook.Plugin\安装版下为%APPDATA%对应子目录内置插件exe 旁的QuickLook.Plugin\两个目录都会递归查找QuickLook.Plugin.*.dll并加载加载完按Priority排序按 Space 时取排序后第一个声明可处理的插件来预览处理不了就回落到默认信息面板。分工建议常用插件图像、视频、压缩包、文本留在内置目录随程序主体走任何机器开箱即用偶尔才用的插件放用户目录随UserData迁移不占程序主体体积安装新插件的方式选中插件文件按 Space内置的 PluginInstaller 会在预览窗显示信息面板点 Install 后插件被复制进用户插件目录再重启 QuickLook 生效。装完后像.apk这类安装包文件就能直接看到版本、包名与权限列表U 盘与公共电脑踩坑清单坑 1Windows 拦截插件文件下载的压缩包里的文件带有「来源标记」Mark of the Web插件.dll可能以0x80131515ERROR_ASSEMBLY_FILE_BLOCKED加载失败。便携模式在 QuickLook/PluginManager.cs 里有一条专属分支先尝试对程序目录内所有文件自动解除阻塞等价于逐个执行Unblock-File并重启程序自动失败则弹出手动指引——在压缩包的「属性」里勾选Unblock再重新解压。所以 U 盘拷贝时更稳妥的做法是先对 zip 解除锁定再解压到 U 盘。坑 2自启动快捷方式指向 U 盘开启「开机自启」会在 Startup 文件夹写入一个指向 exe 的快捷方式见 QuickLook/Helpers/AutoStartupHelper.cs。在公共电脑上不要开如果开了离开前关掉否则快捷方式失效还占着启动项。坑 3分区不可写前面提到的EnsureFolderWritable检查只读分区、受企业策略限制的目录程序会直接退出且不会有明显报错窗口只看到进程闪退。坑 4预览窗残留公共电脑上建议把CloseOnLostFocusTrue/CloseOnLostFocus写进UserData\QuickLook.config窗口失焦即关闭避免你走后预览窗还挂在桌面上。30 秒快速回顾开关只有一个文件portable.lock放在 exe 同目录内容为空数据目录exe 旁的UserData\配置即 XML 文件拷贝它等于备份插件双目录exe 旁QuickLook.Plugin\是内置UserData\QuickLook.Plugin\是用户U 盘两件事zip 先解除锁定、分区必须可写公共电脑三件事别开自启、关自动更新检查、开失焦关闭下一步你可以这样做打开资源管理器「显示文件扩展名」在目标 U 盘上建好portable.lock双击QuickLook.exe完成首跑自检打开 OPTIONS.md 挑选想改的选项直接编辑UserData\下对应的 XML 文件查阅 SUPPORTED_FORMATS.md 了解可预览的文件类型清单按需要往用户插件目录补充插件【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/29 1:17:22 · 阅读 1.2k QuickLook 便携版使用指南：一个 portable.lock 让 U 盘跑起完整预览
QuickLook 便携版使用指南一个 portable.lock 让 U 盘跑起完整预览【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook本文带你免安装使用 QuickLook 便携版在 exe 旁放一个portable.lock全部配置与用户插件就落进程序目录的UserData里拷到 U 盘或公共电脑上按空格即可预览。你还会学到插件双目录的分工以及 U 盘环境下最容易踩的 Windows「解除锁定」坑。它把 macOS 的「空格即览」带到 Windows在资源管理器中选中文件按 Space弹出独立预览窗无需启动重型应用、无需双击等进程启动。便携版与安装版有三处实质差异本文按「开关 → 目录 → 行为」的顺序拆解数据位置从系统目录%APPDATA%\pooi.moe\QuickLook\移到 exe 旁的UserData\用户插件来源从系统目录移到UserData\QuickLook.Plugin\安全处理插件被 Windows 拦截时自动触发解除阻塞逻辑这是便携模式独有的分支QuickLook 如何检测便携模式整个「是否便携」的判断由一个文件决定portable.lock放在可执行文件所在目录。判断逻辑在 QuickLook.Common/Helpers/SettingHelper.cs核心就两行var lck Path.Combine(exe所在目录, portable.lock); return File.Exists(lck);文件内容不重要纯「存在性检测」。程序据此选择数据目录运行模式配置与数据所在位置安装版无 portable.lock%APPDATA%\pooi.moe\QuickLook\便携版存在 portable.lockexe 同级的UserData\QuickLook/App.xaml.cs 把结果暴露为进程级字段IsPortable SettingHelper.IsPortableVersion()。README 的发行版对比表也印证了这一点Portable mode 仅在 Installer 与 Nightly 两种发行形式中可用Store 版是沙盒安装包、Scoop 是托管安装都带不动这个文件。组装便携目录的三步1. 拿全文件不必自己编译直接取 installer 版发布包即可如需从源码构建克隆仓库git clone https://gitcode.com/gh_mirrors/qu/QuickLook便携目录只需要三类东西QuickLook.exe及同目录依赖含QuickLook.Native原生库和各.dllQuickLook.Plugin\内置插件目录你接下来要创建的portable.lock缺了内置插件目录程序能启动但大部分格式没有预览器缺了原生库部分文件类型如缩略图相关功能会失效。2. 创建 portable.lock为什么必须手动建这个空文件是上面检测逻辑的唯一输入没有它就按安装版运行。资源管理器里新建文本文档 → 重命名为portable.lock。先打开「显示文件扩展名」否则实际文件名是portable.lock.txt或 PowerShell 一行New-Item .\portable.lock3. 首跑自检双击QuickLook.exe看两个信号exe 旁出现UserData\目录里面有QuickLook.config在资源管理器选中任意文件按 Space预览窗正常弹出如果第 1 点没出现先检查分区是否可写程序启动时会执行EnsureFolderWritable(LocalDataPath)检查失败直接退出——所以只读分区的 U 盘或受策略管控的目录跑不起来。UserData配置与用户插件的落点程序写入的内容全部收敛在UserData\下配置文件的命名规则见 OPTIONS.mdQuickLook.config主配置托盘图标、窗口透明度、渲染模式、更新开关等QuickLook.Plugin.xxx.config每个插件一份如QuickLook.Plugin.VideoViewer.configQuickLook.Plugin\用户插件的安装位置几个便携场景下值得改的选项DisableAutoUpdateCheckTrue/DisableAutoUpdateCheck关闭启动时的自动更新检查公共电脑上避免尝试拉取新版ProcessRenderMode1/ProcessRenderMode强制纯软件渲染应对老旧 GPU 或驱动异常ExtensionAllowlist/ExtensionBlocklist控制哪些扩展名参与预览安装版下这些文件在%APPDATA%便携版下全在UserData\。所以「备份配置」就是拷贝整个UserData文件夹「换机迁移」同理。插件双目录如何分工QuickLook/PluginManager.cs 的构造函数按固定顺序扫描两个目录用户插件App.UserPluginPath即UserData\QuickLook.Plugin\安装版下为%APPDATA%对应子目录内置插件exe 旁的QuickLook.Plugin\两个目录都会递归查找QuickLook.Plugin.*.dll并加载加载完按Priority排序按 Space 时取排序后第一个声明可处理的插件来预览处理不了就回落到默认信息面板。分工建议常用插件图像、视频、压缩包、文本留在内置目录随程序主体走任何机器开箱即用偶尔才用的插件放用户目录随UserData迁移不占程序主体体积安装新插件的方式选中插件文件按 Space内置的 PluginInstaller 会在预览窗显示信息面板点 Install 后插件被复制进用户插件目录再重启 QuickLook 生效。装完后像.apk这类安装包文件就能直接看到版本、包名与权限列表U 盘与公共电脑踩坑清单坑 1Windows 拦截插件文件下载的压缩包里的文件带有「来源标记」Mark of the Web插件.dll可能以0x80131515ERROR_ASSEMBLY_FILE_BLOCKED加载失败。便携模式在 QuickLook/PluginManager.cs 里有一条专属分支先尝试对程序目录内所有文件自动解除阻塞等价于逐个执行Unblock-File并重启程序自动失败则弹出手动指引——在压缩包的「属性」里勾选Unblock再重新解压。所以 U 盘拷贝时更稳妥的做法是先对 zip 解除锁定再解压到 U 盘。坑 2自启动快捷方式指向 U 盘开启「开机自启」会在 Startup 文件夹写入一个指向 exe 的快捷方式见 QuickLook/Helpers/AutoStartupHelper.cs。在公共电脑上不要开如果开了离开前关掉否则快捷方式失效还占着启动项。坑 3分区不可写前面提到的EnsureFolderWritable检查只读分区、受企业策略限制的目录程序会直接退出且不会有明显报错窗口只看到进程闪退。坑 4预览窗残留公共电脑上建议把CloseOnLostFocusTrue/CloseOnLostFocus写进UserData\QuickLook.config窗口失焦即关闭避免你走后预览窗还挂在桌面上。30 秒快速回顾开关只有一个文件portable.lock放在 exe 同目录内容为空数据目录exe 旁的UserData\配置即 XML 文件拷贝它等于备份插件双目录exe 旁QuickLook.Plugin\是内置UserData\QuickLook.Plugin\是用户U 盘两件事zip 先解除锁定、分区必须可写公共电脑三件事别开自启、关自动更新检查、开失焦关闭下一步你可以这样做打开资源管理器「显示文件扩展名」在目标 U 盘上建好portable.lock双击QuickLook.exe完成首跑自检打开 OPTIONS.md 挑选想改的选项直接编辑UserData\下对应的 XML 文件查阅 SUPPORTED_FORMATS.md 了解可预览的文件类型清单按需要往用户插件目录补充插件【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考