从零搭建WP避坑：首页不显示post的5个狠招

网站被黑挂马不知道怎么办？别慌，先检查代码。很多新手从零搭建WordPress站，刚上线就遇到首页空白或文章消失，其实是配置踩了雷。今天用广东做站的实战经验，手把手教你排查“wordpress首页不显示post”这个老坑，5分钟搞定，省得再被忽悠花钱修站。

需求分析：为什么首页会“隐身”你的文章？

别觉得“首页不显示post”是玄学，90%的情况都逃不出这4个原因：

主题设置里，首页被锁死了：比如默认显示静态页面，却忘了关联文章。
文章状态不对：草稿、私有、密码保护，这些文章首页自然不露脸。
缓存插件作妖：W3 Total Cache、WP Super Cache缓存了旧页面，新文章死活刷不出来。
数据库表损坏：wp_posts 表或 wp_postmeta 表出问题了，数据读不出来。

我自己去年帮一个做跨境电商的客户修站，他首页空白，查了半天，发现是主题里“首页显示最新文章”的选项被关了，改回来就好了。所以别自己吓自己，先按这个思路查，大概率能解决。

环境准备：动手前，这3样东西备好

别急着改代码，先确认你的环境没问题，不然改了也白改：

WordPress版本：至少5.5以上，老版本兼容性问题多，建议直接升到最新版。
主题：如果是免费主题，先备份；如果是付费主题，确认是否支持“首页显示文章”功能。
备份：改之前，用UpdraftPlus或手动备份数据库+文件，万一改崩了还能回滚。

另外，广东这边很多小站还在用虚拟主机，服务器性能差，缓存插件容易冲突。如果你的服务器是低配，建议先把缓存插件停用，再排查问题，能少很多麻烦。

核心步骤：5步定位“不显示post”的根源

步骤1：检查主题设置（最常见！）

进WordPress后台 → 外观 → 自定义 → 首页设置。看“显示最新帖子”有没有勾选。如果选的是“静态页面”，确认你选的页面是不是真的关联了文章。

重点：有些主题（比如Astra、GeneratePress）在“首页”和“博客页”是分开的，你改了首页设置，但博客页没配好，文章照样不显示。一定要两个地方都检查一遍。

步骤2：确认文章状态

进后台 → 文章列表，看你要显示的文章是不是“已发布”。如果是“草稿”“私有”或“密码保护”，首页绝对不会显示。批量检查的话，用高级筛选器，把状态选成“已发布”，看列表里有没有你期待的文章。

小技巧：有些文章发布时间设成了未来时间，或者修改时间太旧，也会被主题过滤掉。改一下发布时间，立刻就能显示。

步骤3：清空所有缓存

浏览器缓存、服务器缓存、WordPress插件缓存，三层都要清：

浏览器：Ctrl+F5强刷。
服务器：如果用了CDN（比如Cloudflare），去后台清缓存。
插件：W3 Total Cache、WP Super Cache、LiteSpeed Cache，全部点“清空缓存”。

注意：清完缓存后，首页可能还是旧的，等30秒再刷。如果还不行，直接换浏览器或无痕模式测试，排除本地问题。

步骤4：检查数据库表（进阶）

如果上面三步都没用，大概率是数据库表损坏了。用phpMyAdmin或WP-DB Manager插件，检查wp_posts和wp_postmeta表。

操作：选中表 → 点击“检查表” → 如果提示“表已损坏”，点“修复表”。修复完再刷新首页，文章可能就回来了。

真实案例：我有个客户，站被黑过，wp_posts表被删了几行数据，文章自然不显示。修复表后，从备份里恢复了数据，首页立刻正常。所以，定期备份数据库，比什么都重要。

步骤5：切换主题测试（终极手段）

如果以上都没用，临时切换到Twenty Twenty-Three（WP官方默认主题），看文章是否显示。如果显示了，说明问题出在你原来的主题上；如果还是不显示，那就是更深层的问题，比如插件冲突或服务器配置。

建议：切换主题前，先备份主题文件。如果确认是主题问题，去GitHub开源仓库找主题的issue区，看看有没有人遇到过同样的问题，通常能找到解决方案。

代码/配置示例：2段能跑的代码，直接抄

示例1：强制首页显示最新文章（functions.php）

如果你用的是自定义主题，或者主题设置里找不到“首页显示文章”的选项，可以在主题的functions.php文件里加这段代码：

// 强制首页显示最新文章，覆盖主题默认设置
function force_home_display_latest_posts() {if ( is_front_page() ) {// 设置首页显示5篇文章$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;$args = array('post_type' => 'post','posts_per_page' => 5,'paged' => $paged);$query = new WP_Query( $args );if ( $query->have_posts() ) {while ( $query->have_posts() ) {$query->the_post();// 输出文章标题和摘要，根据你的主题调整the_title( '<h2 class="entry-title">', '</h2>' );the_excerpt();}}wp_reset_postdata();}
}
add_action( 'template_redirect', 'force_home_display_latest_posts' );

关键说明：这段代码会在首页强制查询已发布的文章，并输出标题和摘要。如果你的主题有自己的首页模板，可能需要调整输出格式。改完保存，刷新首页，文章应该就出来了。

示例2：修复数据库表（SQL命令）

如果数据库表损坏，可以用SQL命令修复。登录phpMyAdmin，选中你的数据库，点击“SQL”标签，输入：

-- 修复wp_posts表
REPAIR TABLE wp_posts;
-- 修复wp_postmeta表
REPAIR TABLE wp_postmeta;

执行后，如果返回“表已修复”，说明成功。如果提示“表不存在”，检查你的表前缀是不是wp_，如果是其他前缀（比如wpsite_），改成对应的前缀再执行。

注意：执行SQL前，务必备份数据库！一旦改错，没备份就回不来了。

常见报错：这3个坑，90%的人都踩过

报错1：首页空白，但文章列表正常
原因：主题首页模板调用的不是文章查询，而是页面查询。
解决：检查主题的front-page.php或home.php文件，看query_posts()或WP_Query的post_type参数是不是post。
报错2：清完缓存还是旧内容
原因：服务器用了对象缓存（比如Redis、Memcached），插件缓存没清到对象缓存。
解决：登录服务器，重启Redis或Memcached服务，或者在WordPress后台用“WP Rocket”这类插件的“清空所有缓存”功能。
报错3：数据库修复后文章还是不显示
原因：文章被软删除，post_status字段被改成了trash。
解决：用SQL查询SELECT * FROM wp_posts WHERE post_status = 'trash';，看有没有你要的文章。如果有，把post_status改成publish，文章就回来了。