必须激活系统原生Quick Look机制并安装QuickLookVideo插件，才能在Mac访达中对MKV、AVI、WebM等格式实现带声音、进度条和控制栏的完整预览；否则空格键仅显示空白或静音首帧。
在Mac的“访达”中选中视频文件后，想不打开播放器就直接看到画面、听到声音、拖动进度条控制播放，必须激活系统原生的Quick Look机制并确保它能完整解码当前视频格式。
启用Quick Look基础预览功能
这一步是所有后续操作的前提，不执行则空格键无效或仅显示空白窗口。
在“访达”中单击选中一个.mp4或.mov文件→按下空格键→观察是否弹出带播放按钮的预览窗口；若无反应，说明Quick Look未正常加载，需先重置缓存。
打开终端，依次执行以下命令：
qlmanage -r
killall Finder
【必须等待Finder完全重启后再测试，否则预览仍不可用】
解决MKV/AVI等格式无法播放的问题
原生Quick Look不支持MKV、AVI、WebM等容器格式的音频解码与画面渲染，空格键会静音或卡在首帧。此时需引入第三方扩展插件补全解码链路。
方法一：安装QuickLookVideo（推荐）
1. 打开终端，运行：
git clone https://gitcode.com/gh_mirrors/ql/QuickLookVideo.git
cd QuickLookVideo
2. 构建依赖：
./scripts/buildffmpeg
./scripts/builddav1d
3. 安装插件：
sudo cp -R build/Release/QLVideo.qlgenerator /Library/QuickLook/
4. 刷新并重启：
qlmanage -r && killall Finder
方法二：使用QLVideo预编译版（免编译）
前往 https://github.com/whomwah/qlvideo/releases 下载最新 .zip 包→解压→双击运行 install.sh 脚本→输入管理员密码→自动完成复制与刷新。
注意：安装后首次预览MKV文件可能需等待3–5秒生成缩略图，这是正常行为，后续预览将立即响应。
调出完整播放控制栏
Quick Look预览窗口默认隐藏底部控制条，必须主动触发才能操作进度、音量和全屏。
第一步：选中视频→按空格键唤出预览窗口
第二步：将鼠标指针缓慢移至窗口最底部边缘
第三步：待控制栏淡入后，点击▶播放按钮启动解码
第四步：悬停在时间轴上，拖动滑块跳转位置；点击音量图标调节输出
【若拖动进度条无响应，说明该视频编码未被当前插件支持，需检查是否为AV1编码的.mkv或含Dolby Vision元数据的.mov】
