本文约 3,823 字，预计阅读 10 分钟。文中命令与配置均经过实测，可直接参考执行。
引言：演示站好看，不等于主题好用
挑选主题最常见的流程是：看演示站截图 → 觉得好看 → 安装 → 导入演示数据 → 发现和自己的内容完全不搭 → 卸载 → 下一个。一个下午能装上卸载七八个主题，最后随便选一个凑合。
问题在于演示站是按主题的最优点设计的：刚好长度的标题、精修过的图片、恰好三句话的段落。这些内容塞进真实站点后照片变成手机横拍、标题长到两行，主题的真实能力才暴露出来。
更多关于免费与付费的结构性差异可参考免费主题与付费主题的真实差异，而挑选本身应该先看那些不依赖演示内容也能验证的客观指标。下面这 10 个指标都能在下载前后用命令或公开信息查到，不需要先装上跑一周。
原理分析：为什么是这 10 个指标
主题质量可以拆成三个层次：
- 能不能用（合规性）：更新状态、PHP/WP 版本兼容、代码是否通过静态检查
- 好不好用（适配性）：区块编辑器支持、可访问性、文档完备度、是否过度依赖插件
- 能跑多快（性能）：文件体积、请求数、外部资源依赖、脚本混屯度
大多数站长只看外观（属于第二层的一部分），忽略了第一层的“能不能用”和第三层的性能。而这三层恰好都可以在装机前用脚本验证。
保姆级实操
指标 1：最近更新时间。 官方目录主题页的 “Last updated” 应在 6 个月内。超过一年没更新的主题，在新版 WordPress / PHP 上迟早出问题。
# 查看已下载主题的头部信息里的版本与更新时间
wp theme list --fields=name,status,version,update --format=table
指标 2：文件总体积与文件数。 一个成品主题（不含演示数据）通常在 1–3 MB 之间；超过 10 MB 往往打包了大量字体、演示图片或内置的行为库。
du -sh wp-content/themes/候选主题/
find wp-content/themes/候选主题/ -type f | wc -l
# 排除演示数据后重新统计
du -sh wp-content/themes/候选主题/ --exclude="*demo*"
指标 3：必需插件数量。 检查是否使用了 TGMPA 强制安装清单。
grep -rn "tgmpa\|is_plugin_active\|require_plugins" wp-content/themes/候选主题/functions.php | head -10
grep -rln "class-tgm-plugin-activation" wp-content/themes/候选主题/
推荐清单里如果混着本可以用几行代码实现的插件（如面包屑、社交分享），说明作者依赖堆砌功能。
指标 4：区块编辑器支持。 现代主题应当提供 editor-style、align-wide、主题调色板等支持。
grep -rn "add_theme_support" wp-content/themes/候选主题/functions.php
期望看到的条目：'editor-styles'、'align-wide'、'wp-block-styles'、'responsive-embeds'、'html5'。缺少 'html5' 或 'title-tag' 属于 Theme Check 的 REQUIRED 问题。
指标 5：是否有 theme.json（区块主题标志）。
ls wp-content/themes/候选主题/theme.json 2>/dev/null && echo "区块主题" || echo "传统主题"
若是传统主题，也应确认未来迁移路径是否清晰（是否已有 FSE 版本）。
指标 6：可访问性。 官方目录有 accessibility-ready 标签，这是经第三方审核过的资质。
grep -rn "accessibility-ready" wp-content/themes/候选主题/readme.txt wp-content/themes/候选主题/style.css
同时确认键盘可达性与对比度 —— 用 Tab 键遍历首屏、用 DevTools 的 Lighthouse Accessibility 跑一次。
指标 7：转义钩子完整性。 wp_head 与 wp_footer 必须在 header.php / footer.php 里存在且位于正确位置。
grep -n "wp_head\|wp_footer\|body_class\|wp_body_open" wp-content/themes/候选主题/header.php wp-content/themes/候选主题/footer.php
四个缺一不可，缺 wp_body_open 会导致部分插件无法插入内容。
指标 8：文档完整度。 优先选提供在线文档站的作者。检查包内有无线上文档链接：
grep -rni "documentation\|docs\|support" wp-content/themes/候选主题/readme.txt | head
指标 9：外部资源依赖。
grep -rEn "https?://fonts\.googleapis\.com|cdnjs|jsdelivr|unpkg" \
wp-content/themes/候选主题/ --include="*.php" --include="*.css" | head -15
外部字体/CDN 一方面影响国内访问速度，另一方面带来隐私合规（GDPR）问题。
指标 10：翻译完整性。
# 存在语言文件说明支持本地化
ls wp-content/themes/候选主题/languages/ 2>/dev/null | head
# 检查是否有未翻译的硬编码字符串（这是翻译不完整的信号）
grep -rn "__(\s*'" wp-content/themes/候选主题/ --include="*.php" | wc -l
落地检查：装主题前先做一次 Theme Unit Test
curl -o theme-unit-test.xml https://raw.githubusercontent.com/WPTT/theme-unit-test/master/themeunittestdata.wordpress.xml
wp plugin install wordpress-importer --activate
wp import theme-unit-test.xml --authors=create
导入后重点检查四个页面：无标题文章、超长标题文章、含图片对齐的文章、含大量评论的页面。这四处的排版表现比演示站更能说明问题。
常见踩坑
- 把演示站的表现当成主题默认表现。演示数据包含大量自定义布局，删掉后回到裸主题往往是另一副样子。
- 只看主题页的“最近更新”而忽略 PHP 版本。主题页标注兼容到 PHP 7.4，而你的服务器已跑 8.3，
Deprecated警告会充满日志。 - 忽略
accessibility-ready与真正可访问的差别。标签只是基础门槛，仍需自己跑 Lighthouse Accessibility 项。 - TGMPA 推荐插件全装。把“推荐”当“必需”安装，会引入一堆你不用的功能。
- 未检查
wp_body_open()。缺这个函数的主题会导致 Google Tag Manager 类插件无法正常工作，且很难排查。 - 忽略子主题机制。直接改父主题文件，一次更新全丢。务必用子主题或
functions.php钩子。 - 案例：某站点挑主题时看中一个 Bundle 体积只有 800 KB 的“极简主题”，上线后发现后台缺
$content_width定义、post-thumbnail未启用，导致所有嵌入视频溢出容器、特色图无法裁剪。作者早已停止维护。最后只能通过子主题补add_theme_support('post-thumbnail')和 CSS 兜底才解决。体积小不等于质量高，有时候只是功能没做完。
总结
把 10 个指标压缩成一个可执行流程（体积与 TTFB 的分项测量脚本见主题体积与加载速度的量化评估）：下载前看更新时间 + 兼容版本 + 标签（accessibility-ready / full-site-editing），下载后跑 du + grep 检查体积、外部资源与依赖情况，最后用 Theme Unit Test 验证边界内容。
给每条指标设一个“一票否决”阈值：超过一年未更新、缺少 wp_body_open、TGMPA 必需插件超过 3 个、 bundle 体积超过 15 MB——命中任意一条就换候选。按这个筛法，十几个候选通常能剩下两三个真正靠谱的。
