WordPress 特色图片尺寸：1200×630 及查看方法

简短回答： 如果你还不知道主题的尺寸，就用 1200 x 630 像素（约 1.91:1）。这是 Facebook 推荐的链接预览尺寸，而 SEO 插件通常会把特色图片用作分享图。

在文章页面上，真正起作用的是主题显示的尺寸。WordPress 会把每张上传的图片保存成多个尺寸，显示哪一个由主题决定。经典主题用 set_post_thumbnail_size() 或 add_image_size() 设置，块主题则在“特色图片”区块中设置。如果主题裁成 16:9 或正方形，1200 x 630 的图片左右两侧可能会被裁掉一部分。先找到主题的尺寸（下文介绍四种方法），再上传至少同样大的图片；为了在高密度屏幕上清晰，宽度最好约为两倍。

想查看 WordPress 会从某张图片生成哪些尺寸，把它拖进 WordPress 图片尺寸工具即可。

按图片显示位置选择尺寸

图片显示位置	上传尺寸	说明
你的文章，尚不知道主题尺寸	1200 x 630，想更清晰可用 2400 x 1260	在你查明主题尺寸期间，也适用于链接预览
你的文章，已知主题尺寸	约为主题特色图片宽度的两倍，宽高比相同	WordPress 只会为上传的图片生成更小的副本，从不生成更大的
Facebook 链接预览	至少 1200 x 630（约 1.91:1）；1200 x 628 的形状几乎相同	来自 Facebook 的分享指南
Google Discover	宽度至少 1200px，16:9（例如 1200 x 675）	来自 Google 的 Discover 指南

WordPress 图片尺寸一览

你上传的每张图片都会为每个已注册尺寸生成缩放副本。以下是 WordPress 核心注册的尺寸，默认值来自 Theme Handbook 和核心函数参考：

尺寸名称	默认尺寸	能在“设置 > 媒体”中修改吗？	说明
thumbnail	150 x 150，裁剪	能	有“裁剪到精确尺寸”复选框
medium	最大 300 x 300	能	按比例缩放
medium_large	宽 768，不限高度	不能	主要用于 srcset
large	最大 1024 x 1024	能	按比例缩放
1536x1536	最大 1536 x 1536	不能	WordPress 5.3 为高密度屏幕新增
2048x2048	最大 2048 x 2048	不能	WordPress 5.3 为高密度屏幕新增
post-thumbnail	由主题设置	不能	只有主题调用 set_post_thumbnail_size() 时才存在
full	你上传的原图	不能	特别大的图片会先被缩小（见下文）

“最大”表示 WordPress 把图片缩放到能放进这个框内并保持比例。一张 2000 x 1000 的照片在 large 中会变成 1024 x 512，而不是 1024 x 1024。

主题和插件经常用 add_image_size() 添加更多尺寸。例如 WooCommerce 会添加自己的商品图尺寸，我们的 WooCommerce 商品图片尺寸指南有详细介绍。

还有一条规则会影响大图。从 WordPress 5.3 起，如果图片宽或高超过 2560 像素，WordPress 会把它缩小，并把缩小后的副本作为可用的最大尺寸。这个阈值来自 big_image_size_threshold 过滤器，默认值为 2560。如果你在文件名里看到 -scaled，想知道要不要关闭它，请阅读如何在 WordPress 中禁用 scaled 图片。

特色图片尺寸到底由什么决定

特色图片就是你在文章编辑器“特色图片”面板中设置的任意一张图片。访客看到什么，取决于主题如何输出它。

经典主题

经典主题会在自己的 functions.php 中开启特色图片并注册尺寸：

add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 1200, 675, true );

set_post_thumbnail_size() 会注册一个名为 post-thumbnail 的尺寸。第三个参数控制裁剪。设为 false（默认）时，WordPress 把图片缩放到能放进 1200 x 675。设为 true 时，它会从中心把图片精确裁成 1200 x 675，16:9 框外的部分都会丢失。你也可以传入 array( 'center', 'top' ) 这样的数组来选择保留哪部分。

很多主题会为不同模板额外注册命名尺寸：

add_image_size( 'hero-wide', 1600, 900, true );
add_image_size( 'card', 600, 400, true );

然后模板按名称选择其中一个：

if ( has_post_thumbnail() ) {
	the_post_thumbnail( 'hero-wide' );
}

不带名称调用时，the_post_thumbnail() 使用 post-thumbnail。所以经典主题的实际特色图片尺寸，就是模板里指定名称的那个尺寸，而博客归档页可能和单篇文章页使用不同的尺寸。

块主题

块主题，包括本站的免费主题，用“特色图片”区块输出特色图片。核心区块参考列出了它的设置，包括 sizeSlug（加载哪个已注册尺寸）、aspectRatio、width、height 和 scale。

这就改变了你要查看的位置。打开“外观 > 编辑器”，编辑“单篇文章”模板，选中“特色图片”区块。侧边栏会显示它加载哪个图片尺寸，以及是否设置了宽高比。宽高比是在浏览器中用 CSS 实现的，所以文件不变，变的是可见的画框。如果区块要求 16:9 的画框而你的图片是正方形，就会有一部分被隐藏。归档页和首页模板可能使用与单篇文章模板不同的设置，所以每个都要检查。

如何找出你的主题使用的特色图片尺寸

按顺序尝试下面的方法，第一个给出答案的就够了。

1. 查看主题文档。 好的主题会写明推荐的特色图片尺寸。如果有，就用它。

2. 用 WP-CLI 列出已注册尺寸。 如果你能使用命令行，wp media image-size 会列出每个已注册尺寸的宽度、高度、裁剪设置和比例：

   wp media image-size

3. 搜索主题文件。 在经典主题中，到 functions.php（以及它引入的文件）里搜索 set_post_thumbnail_size 和 add_image_size，再到 single.php 或模板片段中找传给 the_post_thumbnail() 的名称。在块主题中，按上文所述在站点编辑器里检查“特色图片”区块。

4. 检查线上文章。 右键点击特色图片，选择“检查”，读取 src 中的文件名。WordPress 会在缩放副本的文件名中加入尺寸，所以 my-photo-1200x675.jpg 说明主题加载的是 1200 x 675 的副本。也要看看 srcset，因为在窄屏上浏览器可能选择更小的副本。文件名里没有尺寸，说明用的是全尺寸文件。

知道目标尺寸后，在批量上传前，先用一张样图跑一遍图片尺寸工具，看看每个副本的效果。

选择上传尺寸

知道主题的尺寸后，结果是否好看取决于四个选择。

• 宽度。 上传宽度至少要等于主题的显示宽度。要在高密度的手机和笔记本屏幕上清晰，目标约为两倍宽度。对 1200px 宽的位置来说就是 2400px。WordPress 只会用你的上传图片生成更小的副本，从不生成更大的，所以原图太小是上传后图片模糊最常见的原因。
• 宽高比。 与主题的裁剪比例保持一致。如果它裁成 16:9，就给它 16:9 的图，并把主体放在靠近中间的位置，免得硬裁剪切掉人头或文字。
• 文件大小。 一张以合理质量保存为 JPEG 的 2400px 照片通常只有几百 KB。上传 6000px 的相机原片只会增加工作量：WordPress 反正会缩小所有超过 2560px 的图片，多出来的像素永远到不了访客那里。
• 文件格式。 只要服务器的图像库支持，WordPress 从 5.8 版起支持上传 WebP，从 6.5 版起支持 AVIF。在质量相近时，两者生成的文件通常都比 JPEG 小。

社交分享图是另一回事

有人把你的文章分享到 Facebook、LinkedIn 或其他平台时，预览图来自 og:image 标签，SEO 插件通常用特色图片来填充它。Facebook 的分享文档建议图片至少 1200 x 630 像素，并尽量接近 1.91:1 的比例。

你还会看到有人推荐 1200 x 628。它几乎正好是 1.91:1，而 1200 x 630 约为 1.90:1。两者高度只差 2 像素，用哪个都可以。

如果你的主题显示尺寸也接近 1.91:1，一张 1200 x 630（或 2400 x 1260）的图片两边都能用。如果主题裁成 16:9 或正方形，请让重要内容远离左右两侧边缘，或在 SEO 插件里单独设置社交分享图。

Google Discover 对图片有自己的建议。Google 的 Discover 指南建议图片宽度至少 1200px、总像素超过 300,000，并采用 16:9 比例，例如 1200 x 675。大图还需要 max-image-preview:large 这个 robots 设置，WordPress 从 5.7 版起默认添加它，除非网站设置了“建议搜索引擎不索引本站点”。

如何修改特色图片尺寸

在哪里修改，取决于尺寸类型和你的主题。

核心尺寸（thumbnail、medium、large）。 进入“设置 > 媒体”，修改宽度和高度。媒体设置页面文档介绍了这些字段，包括缩略图的裁剪复选框。

经典主题中的主题尺寸。 不要修改父主题，因为主题更新会覆盖你的修改。把新数值加到子主题的 functions.php 中。用相同名称重新注册一个尺寸会替换它，而子主题的设置需要在父主题之后运行：

add_action( 'after_setup_theme', function () {
	set_post_thumbnail_size( 1600, 900, true );
	add_image_size( 'hero-wide', 1600, 900, true );
}, 11 );

优先级 11 让这段代码在以默认优先级 10 挂载的父主题之后运行。请检查父主题的代码，如果它用了更晚的优先级，就相应调整。

块主题。 在站点编辑器模板中修改“特色图片”区块的图片尺寸和宽高比。无需代码，修改会应用到使用该模板的所有文章。

单张图片，无需代码。 要决定某一张图片裁剪时保留哪部分，可在“媒体 > 媒体库”中打开它，点击“编辑图片”。按主题的比例裁剪（裁剪工具可以输入 16:9 这样的宽高比），或者缩放它，然后保存。WordPress 会把修改应用到这张图片的所有尺寸，并保留原始文件，以后可以用“恢复原始图片”撤销。

重新生成现有缩略图

修改后的尺寸只对新上传的图片生效。媒体库中已有的图片会保留旧副本，直到你重建它们。wp media regenerate 命令可以完成这件事：

wp media regenerate --yes

WP-CLI 文档中几个实用的选项：

• --image_size=hero-wide 只重建这个尺寸。需要多个尺寸时重复这个参数。
• --only-missing 只生成还不存在的尺寸，不动已有文件，添加新尺寸后用它更快。
• --skip-delete 保留旧的缩略图文件。如果其他网站、邮件简报或订阅源直接链接这些文件，就用它。

没有命令行时，WordPress.org 插件目录中的 Regenerate Thumbnails 插件可以在后台完成同样的工作。媒体库很大时请先备份，因为重新生成会改写大量文件。

常见错误

• 只停留在 1200 x 630。它是不错的起点，也适合链接预览，但如果你的主题裁成 16:9 或正方形，图片会被切掉一部分。批量上传前请先确认主题的尺寸。
• 为了“保留原图”而关闭生成的尺寸。如果主题没有更小的副本，它可能在所有屏幕上都加载完整文件，让手机上的页面变慢。缩放副本正是为了避免这种情况。
• 改了图片尺寸代码却跳过重新生成。代码是有效的，但只对新上传的图片有效。很多人认为改尺寸“没有用”，原因就在这里。
• 在父主题里修改尺寸。下一次主题更新就会把它删掉。请使用子主题或站点编辑器。

如果尺寸和比例都已匹配、也重新生成过，图片看起来仍然不对，请把浏览器加载的文件名与图片尺寸工具显示的 WordPress 应生成的尺寸对比。两者不一致时，往往是 WordPress 与访客之间的优化插件或 CDN 图片缩放服务在提供它自己的版本。