WordPress 静态首页完全指南
WordPress 默认将新文章列表作为网站首页，但多数企业站、个人品牌站需要的是一个独立的静态首页——用来展示公司介绍、核心产品、品牌形象等固定信息。实现这一需求，关键在于理解 WordPress 的模板层级（Template Hierarchy）机制：系统按照特定顺序查找模板文件，找到哪个就用哪个。本文基于 WordPress 官方主题开发文档，结合实际开发经验，梳理静态首页的配置逻辑、模板文件的选择规则，以及开发中的常见问题和解决方案。无论你是想快速搭建企业官网，还是开发自己的 WordPress 主题，这份指南都能帮你理清思路。
一、理解 WordPress 首页的两套逻辑
在开始之前，先明确两个概念，它们贯穿全文：
- 静态首页（Front Page）：网站入口页面，显示固定的介绍内容，而非动态文章列表。
- 文章索引页（Blog Index）：显示新文章列表的页面，也就是传统的博客首页。
进入 WordPress 后台的 设置 → 阅读，你会看到“首页展示”选项，它决定了网站首页展示什么内容：
| 选项 | 首页显示内容 |
|---|---|
| 新文章 | 显示博客文章列表（动态更新） |
| 静态页面 | 显示你指定的某个页面的内容（固定不变） |
这个设置直接影响 WordPress 选择哪个模板文件来渲染首页。下面是完整的模板选择流程。
二、首页模板选择流程
当用户访问网站根目录（例如 https://你的域名.com）时，WordPress 按以下顺序查找模板文件：
1. 如果存在 front-page.php
直接使用 front-page.php，不再往下查找。
2. 如果没有 front-page.php
根据后台“首页展示”的设置，走不同分支：
情况 A：设置为“静态页面”
WordPress 按以下顺序查找模板：
- 该页面指定的自定义页面模板（在页面编辑器中选中的模板）
page-{页面ID}.phppage-{页面别名}.phppage.phpindex.php
情况 B：设置为“新文章”
WordPress 按以下顺序查找模板：
home.phpindex.php
三、开发中的关键判断函数
在实际开发中，你经常需要判断当前页面是首页还是文章索引页，以便输出不同内容。WordPress 提供了两个条件标签：
is_front_page()
判断当前是否显示网站首页，无论后台设置的是“静态页面”还是“新文章”，只要在首页就返回 true。
is_home()
判断当前是否显示文章索引页。分两种情况：
- 后台设置为“新文章”时，首页就是文章索引页，所以
is_front_page()和is_home()同时为true。 - 后台设置为“静态页面”时，只有访问被指定为“文章页”的那个页面时，
is_home()才返回true。
注意：在模板开发中，
is_front_page()更适合作为首页判断标准，因为它无论何种设置都准确指向网站入口。
四、核心模板文件详解
front-page.php
这是站点首页的专属模板。只要这个文件存在，无论后台如何设置首页展示方式，WordPress 都会优先使用它来渲染首页。
开发中的典型做法：在这个文件中加入条件判断，让它根据后台设置自适应显示内容。
php
<?php
/**
* 站点首页模板
* 根据后台设置自动切换显示静态页面或文章列表
*/
if ( 'posts' == get_option( 'show_on_front' ) ) {
// 后台设置为“新文章”：载入文章索引模板
include( get_home_template() );
} else {
// 后台设置为“静态页面”：在这里编写静态展示内容
// 也可以直接载入页面模板：include( get_page_template() );
?>
<div class="front-page-content">
<h1>欢迎来到我们的网站</h1>
<p>这里是静态首页展示内容</p>
</div>
<?php
}
?>
home.php
这是文章索引页的专用模板，只有当后台设置为“新文章”或访问被指定为“文章页”的静态页面时才会用到。
注意：不要为文章索引页创建自定义页面模板（如 template-blog.php），原因有二：
- 当正确配置静态首页功能后，WordPress 不会使用自定义页面模板来显示文章索引，即便你给“文章页”指定了自定义模板也不会生效。
- 如果你将自定义页面模板分配给一个普通页面，该页面的文章列表分页会出现问题。
自定义页面模板
如果你希望首页使用一个独特的布局（如全屏轮播、分栏展示等），可以在页面编辑器中通过“页面属性”选择自定义模板。WordPress 会优先使用这个模板来渲染首页。
五、进阶开发技巧
1. 在静态首页中嵌入新文章列表
如果你希望在静态首页中展示部分新文章（例如显示 3 条新动态），可以使用自定义查询：
php
<?php
$recent_posts = new WP_Query( array(
'posts_per_page' => 3,
'post_status' => 'publish'
) );
if ( $recent_posts->have_posts() ) : ?>
<ul class="recent-posts-list">
<?php while ( $recent_posts->have_posts() ) : $recent_posts->the_post(); ?>
<li>
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
<span class="post-date"><?php echo get_the_date(); ?></span>
</li>
<?php endwhile; ?>
</ul>
<?php wp_reset_postdata(); // 恢复主循环数据 ?>
<?php endif; ?>
2. 通过过滤器调整模板加载逻辑
如果你希望在后台设置为“新文章”时直接使用 home.php，而不经过 front-page.php，可以在主题的 functions.php 中添加过滤器：
php
function custom_front_page_template_control( $template ) {
if ( is_home() ) {
// 当显示文章索引时，返回空字符串让 WordPress 回退到 home.php
return '';
}
return $template;
}
add_filter( 'frontpage_template', 'custom_front_page_template_control' );
3. 关于分页的重要提醒
静态首页不设计为分页。WordPress 的分页函数（如 previous_posts_link、next_posts_link）在静态首页上无法正常工作。静态首页的分页使用 page 查询变量，而非 paged。
如果你需要在静态首页上实现分页功能，请使用 WP_Query 配合 paged 参数，并自行处理分页链接的生成。
六、常见问题与解决方案
Q：我创建了 front-page.php，但访问首页时并没有生效。
检查文件命名是否正确，注意是 front-page.php 而非 frontpage.php（中间有连字符）。另外确认文件位于当前启用的主题根目录下。
Q：我设置了“静态页面”作为首页，并指定了自定义页面模板，但没有效果。
检查你是否创建了 front-page.php 文件。如果存在 front-page.php，它会优先于自定义页面模板被使用。要么删除它，要么在 front-page.php 中通过 include( get_page_template() ) 引入你的自定义模板。
Q：is_front_page() 和 is_home() 傻傻分不清。
简单记忆：is_front_page() 永远是“网站入口”，is_home() 是“文章列表页”。当后台设为“新文章”时，两者都是 true；设为“静态页面”时，只有首页为 true，文章页为 false。
总结
WordPress 首页模板的选择遵循清晰的优先级规则。作为开发者，你需要记住以下几点：
front-page.php拥有高优先级，只要存在就一定会被使用。- 后台“首页展示”设置决定了当没有
front-page.php时的模板选择路径。 is_front_page()是判断首页的可靠函数，is_home()专用于判断文章索引页。- 静态首页和文章索引页由不同模板处理，不要混用。
- 在静态首页中嵌入动态内容（如新文章）时，务必使用
wp_reset_postdata()恢复主循环。
理解这套机制后，你就能自如地控制 WordPress 网站的首页呈现方式，无论是企业展示站还是个人博客，都能找到合适的实现方案。