组织你的WordPress主题文件：一份给初学者的清晰指南
对于刚接触WordPress主题开发的初学者来说，面对一堆PHP文件、CSS文件和文件夹，很容易感到困惑。但好消息是，一个结构清晰的主题不仅让你自己看得明白，也让WordPress能地找到它需要的模板，从而正确地展示你的网站内容。这篇文章会带你理清WordPress经典主题的文件结构，告诉你哪些文件是必不可少的，哪些文件夹能帮你把东西收拾得井井有条。
核心文件：一个主题的骨架
从技术上讲，一个能运行的WordPress主题只需要两个文件：style.css 和 index.php 。它们就像是主题的身份证和万能钥匙。
style.css(主样式表)：这个文件至少要做两件事。一，在文件顶部，以注释的形式提供主题的“身份证”信息，比如主题名称、作者、版本等。这样WordPress才能在后台的“外观”>“主题”页面里认出你的作品 。二，它存放着控制网站外观的CSS样式代码。注意，style.css必须直接放在主题的根目录下，而不是子文件夹里 。一个典型的style.css文件开头是这样的：css/* Theme Name: 我的一个主题 Author: 你的名字 Version: 1.0 */index.php(主模板文件)：这是所有模板文件的“后的依靠” 。当WordPress找不到某个更具体的模板（比如找不到single.php来显示单篇文章）时，它就会退而求其次，使用index.php来兜底。它确保了你的网站无论发生什么情况，都不会“无页可显”。
让结构更清晰：推荐的文件与文件夹
虽然WordPress只要求两个文件，但一个的主题通常包含更多文件，以区分不同部分的显示逻辑。同时，合理的文件夹划分能让你的主题目录看起来整洁有序，方便日后修改和维护 。
常用的模板文件
这些文件通常放在主题的根目录下，它们各自负责网站特定部分的显示 ：
header.php&footer.php：分别用于显示网站的页眉（通常包含导航菜单）和页脚部分。它们像积木一样，被其他模板文件（如index.php或page.php）通过get_header()和get_footer()函数调用，实现了代码的复用。single.php：专门用来显示单篇文章的模板。page.php：专门用来显示“页面”这种内容类型的模板。functions.php(功能文件)：这个文件非常特殊，它不直接输出任何可见内容，而是为主题添加各种“超能力”。比如，你可以在这里注册导航菜单、添加文章缩略图支持、引入CSS或JS文件等 。它就像一个幕后英雄，驱动着主题的各种高级功能。comments.php：用来显示和管理文章或页面评论区域的模板。
推荐的文件夹结构
把不同类型的文件分门别类放进文件夹，是体现一个开发者度的好习惯。以WordPress默认的Twenty Seventeen主题为例，其结构值得参考 ：
assets/(资源文件夹)：通常用来存放主题的前端资源。css/：存放额外的CSS文件。js/：存放JavaScript文件。images/：存放主题自带的图片。
inc/(包含文件夹)：这里的“inc”是“include”的缩写，通常用来存放一些辅助性的PHP代码片段或类，避免把functions.php文件塞得太满，使其更专注于主题功能的注册。template-parts/(模板部件文件夹)：这里存放可以被多次重用的模板片段，比如一篇博客文章的布局（content.php）或一个商品卡片的布局。它们通常通过get_template_part()函数被调用，大提高了代码的整洁度和复用性。
两个特殊的目录
page-templates/(页面模板文件夹)：从WordPress 3.4版本开始，如果你把自定义的页面模板文件放在这个文件夹里，WordPress就能自动识别到它们。这样，你在编辑页面时，就能在“页面属性”里方便地选择这些模板了。languages/(语言文件夹)：如果你想让主题支持多语言，可以在这里存放翻译文件（通常是.mo和.po文件），这样主题就能轻松国际化，被翻译成其他语言。
总结
构建一个结构清晰的WordPress主题，关键在于“分而治之”：