不打开 Office 也能看 Word、Excel 和 PPT：QuickLook 原生预览插件上手指南

不打开 Office 也能看 Word、Excel 和 PPT：QuickLook 原生预览插件上手指南

【免费下载链接】QuickLook.Plugin.OfficeViewer-NativeView Word, Excel, and PowerPoint files with MS Office and WPS Office components.项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook.Plugin.OfficeViewer-Native

QuickLook.Plugin.OfficeViewer-Native 是一个 Windows 平台 QuickLook 的文件预览插件：在文件管理器中选中 Office 文件后按空格键，文档内容会直接以浮窗形式渲染出来，而无需先启动完整的 Office 程序。它适合经常需要在资源管理器里翻查合同、报表、课件等文档的办公人员、学生和开发者。插件借助系统已安装的微软 Office 组件完成渲染，效果更接近真实文档，但前提是机器上装了兼容的办公套件。

在文件管理器里看 Office 文件的成本

日常浏览文件时有几个具体的摩擦点：

• 只想确认一行合同条款或一个单元格的数据，却要先双击打开 Word 或 Excel，等窗口完全加载。
• 附件、发票、学生作业这类文件数量多，逐个点开、关闭，操作本身就成了负担。
• 资源管理器自带的缩略图对 Office 文件常常只显示一个通用图标或几行残缺文字，参考价值有限。

预览式查看的思路是把"看一眼"和"要编辑"区分开：在文件列表中保持选中状态，用空格键唤出预览窗口查看内容，不需要进入完整编辑器；看完按 Esc 收起即可。

安装前建议确认的三件事

这个插件不是独立程序，它的工作依赖两个前置条件，装之前先自查：

1. QuickLook 主程序已安装并驻留后台。插件只是 QuickLook 的扩展，没有主程序时插件无法工作。
2. 机器上装有兼容的办公套件。根据项目 README，微软 Office 是稳定可用的依赖；WPS Office 在多数用户反馈下并不支持，如果你主要使用 WPS，建议装好后用真实文件实测一次再决定是否保留。
3. 目标文件的扩展名在插件覆盖范围内（下一节列出）。插件只对能匹配到系统预览处理器注册的文件生效。

安装与首次验证流程

按项目 README 的步骤操作即可：

1. 从项目的 Release 页面下载最新的.qlplugin插件包。
2. 确认 QuickLook 正在后台运行，在下载目录中选中该.qlplugin文件，按空格键。
3. 在弹出的窗口中点击"Install"按钮完成安装。
4. 重启 QuickLook 使插件生效。
5. 验证：找一个本地硬盘上的.docx文件（避免先测网上下载的文件，见后文"受保护视图"说明），选中后按空格键。预览窗口中显示出完整文档页面，即表示插件工作正常。

哪些 Office 格式可以预览

插件注册的扩展名列表如下：

需要说明的是，扩展名在列表里不等于一定能预览。插件在接管一个文件前，会到系统注册表中查询该扩展名是否登记了对应的预览处理器；查不到就不会生效。这也解释了为什么同一份文件在 A 电脑上能预览、在 B 电脑上不行——差异来自两台机器安装的办公套件版本和组件不同。

它为什么叫"Native"

源码很短，核心只有几个文件（均在项目根目录）：

• Plugin.cs：插件入口，负责扩展名匹配、接管预览和生命周期管理。
• PreviewHandlerHost.cs：宿主控件，通过IPreviewHandler接口调用办公套件向系统注册的"预览处理器"。
• PreviewPanel.cs 与 PreviewPanel.xaml：把宿主控件嵌入 QuickLook 的预览窗口。

"Native"的含义即此：插件不自带解析引擎，而是复用 Office 自身注册的预览组件来渲染页面。因此渲染保真度通常高于第三方通用解析库，代价是必须依赖本机已安装的套件。

常见预览问题排查

预览窗口空白或根本不出预览

按顺序检查：办公套件是否真正安装并启用；文件扩展名是否为标准名称（例如把.doc改名为.docx不会让插件识别它）；重启 QuickLook 后再试。仍不行时，用完整 Office 程序打开该文件确认文件本身未损坏。

提示"PROTECTED VIEW"且看不到内容

来自互联网的文件（下载的附件、邮件中的文档）带有"互联网区域"标记，Office 的受保护机制不允许预览界面加载它。此时插件会弹出确认框，询问是否解除该文件的区域标记；选择"否"则只显示一行说明文字。若不放心直接解除标记，可以把文件复制到本地目录后再预览。

某个格式单独失败

先用完整办公程序打开该文件验证其完整性，再核对扩展名是否在覆盖列表内。个别启用宏的格式（.docm、.xlsm）依赖套件注册状态，换一台装了同类 Office 的电脑对比测试能快速定位是文件问题还是环境注册问题。

预览响应明显变慢

大体积文档（多表格、大量嵌入图片）的预览渲染本身需要时间，属正常现象；可等待渲染完成，或避免同时连续切换大量文件。若日常小文件也明显变慢，建议检查系统资源占用后再观察。

获取源码与了解维护状态

项目以 MIT 协议开源。根据仓库 README 的说明，该插件已并入 QuickLook 主项目分支，本仓库不再单独维护，最新功能状态建议以仓库说明为准。

源码为 C#/WPF 结构，除上文提到的核心文件外，打包与版本脚本位于 Scripts/ 目录（pack-zip.ps1用于生成.qlplugin安装包，update-version.ps1用于同步版本号）。想本地构建时，克隆仓库后注意更新子模块，以 Release 配置构建，再运行打包脚本即可在目录中得到QuickLook.Plugin.OfficeViewer.qlplugin文件。克隆命令：

git clone https://gitcode.com/gh_mirrors/qu/QuickLook.Plugin.OfficeViewer-Native

如果你的日常工作流里经常需要在文件管理器中快速核对 Office 文档，可以按文中的顺序操作：确认装了 QuickLook 和微软 Office，下载安装插件，然后用一份真实.docx文件验证预览是否生效。

【免费下载链接】QuickLook.Plugin.OfficeViewer-NativeView Word, Excel, and PowerPoint files with MS Office and WPS Office components.项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook.Plugin.OfficeViewer-Native