积磊截图 · 故障排查

截图出来是黑屏或者整块空白怎么办?

macOS 上绝大多数是屏幕录制权限没授予:应用会先主动检查并弹系统授权框,仍未授权时直接提示失败并给出「打开系统设置」按钮,不会给你一张黑图。去「系统设置 → 隐私与安全性 → 屏幕与系统音频录制」打开开关,然后完全退出应用再启动。Windows 上没有这个权限项,黑屏通常与显卡加速、远程桌面或受保护的窗口(如部分视频播放器)有关。

WindowsmacOS适用版本:2.11.2

内容核验:

分步操作

  1. macOS 先查权限

    系统设置 → 隐私与安全性 → 屏幕与系统音频录制。

  2. 打开开关并重启应用

    完全退出(托盘 → Exit)再启动。

  3. 再试一次截图

    按热键或用托盘菜单的 Screenshot。

  4. Windows 上换场景试

    换个窗口、断开远程桌面,确认是否与特定窗口有关。

预期结果

截图窗口显示正常画面,不再出现黑屏。

异常与解决

macOS 整块黑屏

可能原因:屏幕录制权限未授予

解决方法:系统设置 → 隐私与安全性 → 屏幕与系统音频录制,打开开关后重启应用

前台窗口是黑的,其它正常

可能原因:该窗口受 DRM / 硬件叠加保护

解决方法:换用窗口外的区域,或改用该程序自带的导出功能

Windows 上黑屏

可能原因:远程桌面会话、显卡驱动或硬件加速异常

解决方法:断开远程桌面后本地重试;更新显卡驱动

应用弹出权限提示

可能原因:截图前预检发现未授权

解决方法:点提示里的「打开系统设置」授权,再重启应用

注意事项

  • 源码刻意让 macOS 在无权限时抛错提示,而不是返回一张黑图。
  • 不要为了截图关闭系统安全功能;授权这一个应用即可。