要使 README 屏幕截图保持一致,请选择一个目标宽度和高宽比,使用相同的窗口或选区取景截取每个屏幕,然后使用“预览”裁剪并调整图像大小以获得匹配的像素尺寸。macOS 内置的“截屏”控件支持窗口截取和手动选区截取,但 Apple 文档记录的控件并未提供用于输入截屏边框精确宽高的数值输入框。请使用“预览”获得精确的最终尺寸,并检查调整大小后界面文本是否变形。
选择可重复的取景框
确定 README 图像需要说明的内容:整个应用程序窗口、特定的界面区域,还是一组相关的连续界面。对于系列图片,请保持主体和取景一致。窗口截取适合整个应用程序窗口;当窗口外框或周围的桌面可能会造成干扰时,截取选定区域则很有用。macOS 同时支持这两种方式以及全屏截取。Apple Mac 截屏指南
如果使用 Shift-Command-4 截取选定区域,请拖移以圈选内容,然后松开以拍摄屏幕截图。拖移时按住空格键,可以在不改变选区大小的情况下移动选区。这有助于在一次又一次的截屏中以类似方式放置选框,但 Apple 没有提供用于输入精确像素尺寸的控制项。请将手动选框仅视为起始步骤,而不能证明两个文件具有完全相同的尺寸。
若要截取窗口,请打开目标窗口并按 Shift-Command-4,然后按空格键,再点按该窗口。点按时按住 Option 键可去除窗口阴影。这样可以生成直接以窗口为对象的图像,但不同的窗口大小可能会产生不同的输出尺寸。在拍摄一组屏幕截图之前,请将应用窗口调整为一致的尺寸,并保持其可见内容布局相似。调整窗口大小是实际操作流程中的选择;截屏工具本身并不会锁定窗口大小。
在 Mac 上设置“截屏”选项
按 Shift-Command-5 打开“截屏”。选择截取模式,然后打开选项以设置定时器、选取存储位置、控制浮动缩略图,并决定是否显示指针。较短的定时器可让你有时间将指针移离重要文本,或在截屏前准备好菜单。在截取一系列图片时,请保持指针设置一致。Apple 记录了这些“截屏”选项。
请使用统一的存储文件夹,以便轻松找到原始图像。如果跨代码库查看器的 README 兼容性很重要,当“截屏”应用提供格式选项时,请选择 SDR(最兼容);Apple 指出此选项使用 PNG 格式,而在装有 macOS Tahoe 26 或更高版本的受支持 Mac 机型上,HDR 则使用 HEIF 格式。切勿假设每台 Mac 或更早的 macOS 版本都会显示此格式菜单。
在“预览”中裁剪和调整大小
在“预览”中打开屏幕截图。若要裁剪,请显示“标记”工具栏,选取“矩形选择”,拖移以选定要保留的区域,然后点按“裁剪”。如果“裁剪检查器”可用,你可以检查所选内容的尺寸。为同一组图像中的每张图像应用相同的裁剪边界或高宽比,以确保视觉取景一致。Apple 的“预览”指南介绍了裁剪和尺寸检查方法。
接着,选取工具 > 调整大小。输入所需的宽度和高度;如果保持原始比例很重要,请确保勾选按比例缩放。“预览”可能会将其中一个维度调整得小于所要求的大小,以保持这些比例。强行输入不相称的宽度和高度值可能会拉伸界面;如果图像的比例与你的目标不符,请先裁剪为目标形状,然后再调整大小。如果你想保留未裁剪的原图,请另存一份副本。
当多个图像显示在同一个窗口并在其边栏中被选中时,“预览”可以同时调整多个图像的大小。这有助于应用统一的尺寸,但事后请逐一检查每张图像:共用同一个调整大小操作并不会自动使它们的裁剪范围或主体保持一致。Apple 介绍了在“预览”中批量调整大小的方法。
在 README 中验证图像
在“预览”中对比最终文件:检查它们的像素尺寸、高宽比、裁剪边界、清晰度以及指针可见性。然后将它们添加到代码库中,并在 Markdown 中使用相对路径进行引用,例如 。GitHub 文档记录了针对渲染代码库内容(包括 README 文件)使用相对图像路径的规范。GitHub 文档:关于代码库 README 文件。
实用的可重复流程是:设置应用窗口、一次性配置好“截屏”选项、截取系列图片、将所有图像裁剪为相同的高宽比、按比例缩放到同一个目标宽度,最后验证生成的尺寸。内置工具使得获得一致的效果变得切实可行,但要获得精确的取景框尺寸,仍需在“预览”中检查并调整生成的图像。
来源
在 Mac 上拍摄屏幕截图 — Apple 支持
在 Mac 上的“预览”中裁剪、调整大小或旋转图像 — Apple 支持
关于代码库 README 文件 — GitHub 文档