启用powertoys peek功能后,可通过悬停或快捷键预览文件内容。需在设置中开启功能、配置触发方式(悬停或快捷键)、勾选支持的文件类型,并可自定义预览窗口样式;异常时检查扩展名、编码及重启powertoys。

如果您安装了 PowerToys 并启用了 Peek 功能,即可在不打开对应应用程序的情况下,通过悬停或快捷键快速预览图片、文档、代码等文件内容。以下是启用与使用 Peek 的具体步骤:
一、启用 Peek 功能
Peek 默认处于禁用状态,需在 PowerToys 设置中手动开启,并配置触发方式与支持的文件类型。启用后,系统将注入预览服务并监听鼠标悬停或键盘事件。
1、启动 PowerToys 应用程序,点击左侧菜单栏中的 Peek 选项。
2、将顶部开关切换为 On,启用该功能。
3、在 Trigger mode 区域选择触发方式:勾选 Hover over file in File Explorer 启用资源管理器中悬停预览,或勾选 Keyboard shortcut 并设置自定义快捷键(如 Ctrl+Shift+P)。
4、点击 File types 标签页,确认所需扩展名已勾选,例如 .jpg, .png, .pdf, .txt, .py, .js, .md 等。
二、在文件资源管理器中悬停预览
此方式适用于浏览本地文件夹时快速确认内容,无需双击打开,依赖 Windows 文件资源管理器的缩略图与文本渲染能力。
1、打开文件资源管理器,导航至包含目标文件的文件夹。
2、将鼠标指针悬停在目标文件图标上,保持静止约 300 毫秒。
3、预览窗口自动弹出,显示图像缩略图、PDF 页面、纯文本内容或代码高亮片段(取决于文件类型与系统支持)。
4、移动鼠标离开文件区域,预览窗口立即消失;再次悬停可重新调出。
三、使用快捷键触发 Peek 预览
当文件未在资源管理器中聚焦,或需对桌面/其他窗口中的文件进行预览时,快捷键方式更灵活,支持对当前焦点文件或选中项直接调用。
1、在文件资源管理器中选中一个文件(单击),确保其处于高亮状态。
2、按下已配置的 Peek 快捷键(如默认未设置,则需先在设置中指定)。
3、预览窗口以半透明浮层形式出现在屏幕中央,显示该文件的结构化内容。
4、按 Esc 键或点击窗口外部任意位置关闭预览。
四、调整 Peek 显示行为与样式
Peek 支持自定义预览窗口尺寸、透明度、边框及文本字体,以适配不同分辨率与视觉偏好,避免遮挡背景信息。
1、在 Peek 设置页中,展开 Preview window appearance 区域。
2、拖动 Opacity 滑块设定透明度(建议 85%–95%,兼顾可读性与背景可见性)。
3、在 Size 下拉菜单中选择预览窗口比例(Small / Medium / Large)。
4、勾选 Show border around preview window 以增强窗口边界识别度。
五、排查常见预览异常
部分文件无法预览通常源于扩展名未注册、编码不可读或系统组件缺失,Peek 依赖 Windows 内置渲染器与 PowerToys 的解析模块协同工作。
1、检查文件扩展名是否列在 File types 列表中,若未出现,手动输入并点击 Add。
2、对 UTF-8 以外编码的文本文件(如 GBK 编码的 .txt),右键文件 → 属性 → 详细信息,确认“内容”字段可被系统读取;否则 Peek 可能显示乱码或空白。
3、重启 PowerToys 主进程:右键任务栏 PowerToys 图标 → Restart PowerToys,使新配置即时生效。
4、若 PDF 预览失败,确认系统已安装 Windows 内置 PDF 查看器(Windows 10 1809 及以上版本默认具备)。











