WordPress主题开发：style.css文件完全指南
每个WordPress主题都必须有一个style.css文件，这是WordPress主题结构的基础。对这个文件，许多初学者存在一个普遍的误解：认为它仅仅是用来存放CSS样式代码的。实际上，它的首要任务是“告诉”WordPress你的主题是什么，就像一个身份证。WordPress通过读取这个文件顶部的一段特定注释来获取主题的名称、作者、版本、功能描述等关键信息，这些信息会直接显示在后台的“外观 > 主题”页面中。本文将深入剖析style.css文件的头部注释区，逐一解释每个配置字段的含义与用法，并涵盖父主题与子主题的不同配置方式。读完本文，你将能独立创建符合WordPress规范的主题声明，为后续的主题开发工作打下坚实基础。
一、style.css 的核心作用
在WordPress主题目录中（通常是/wp-content/themes/），每个主题都有自己的文件夹。WordPress在扫描可用主题时，会进入每个文件夹寻找style.css文件。一旦找到，它会读取该文件开头的部分数据，从中提取主题的“身份信息”。
你可以把style.css理解为你的主题的“名片”或“注册表”。即使你的样式表里还没有任何CSS代码，只要文件头部包含了必要的声明，WordPress就能识别并激活它。
补充一点：虽然
style.css主要承担“注册”功能，但它同时也是一个货真价实的样式表文件。你可以在其中编写CSS代码来控制网站外观。不过在现代区块主题（Block Theme）开发中，样式更多地通过theme.json文件来管理，这个我们会在其他文章中详述。
二、小的有效主题声明
要让WordPress识别你的主题，你至少需要在style.css文件中提供主题名称（Theme Name）。一个简单的示例如下：
css
/** * Theme Name: 我的一个主题 */
仅仅这样一行代码，你的主题就能出现在后台的主题列表里。但很显然，这远远不够——你需要在后台展示更多关于主题的信息，让用户知道它的用途、版本、作者等，所以我们需要配置更多的字段。
三、标准头部字段详解
下面是一个包含了所有常用配置字段的style.css头部示例。我建议你实际创建主题时，可以把它作为模板来使用：
css
/** * Theme Name: 落日晚霞 * Theme URI: https://example.com/luo-ri-wan-xia * Description: 一款为摄影爱好者设计的简博客主题，支持全站编辑。 * Version: 1.0.0 * Author: 张三 * Author URI: https://zhangsan.me * Tags: blog, photography, block-patterns, full-site-editing * Text Domain: luoriwanxia * Domain Path: /languages * Tested up to: 6.6 * Requires at least: 6.4 * Requires PHP: 7.4 * License: GNU General Public License v2.0 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html */
现在我们逐一拆解每个字段的含义：
Theme Name（主题名称）
你的主题的名称。注意，这个名称不应该与已有主题重名，否则可能导致混淆。它会显示在后台主题列表以及网站前台的某些地方。
Theme URI（主题主页）
指向一个能提供主题详细信息的网页。可以是你的个人网站、主题演示站或GitHub仓库地址。用户点击主题详情时可能会看到这个链接。
Description（主题描述）
用一句话简要描述你的主题是做什么的、有什么特色。这段文字会出现在后台的“主题详情”弹窗中，是吸引用户尝试的重要文案。
Version（版本号）
推荐使用主版本.次版本.修订号的格式，例如1.0.0。每次发布更新时记得递增版本号。
Author（作者）
主题开发者或开发团队的名称。如果你计划将主题提交到WordPress官方主题库，官方建议使用你的WordPress.org用户名。
Author URI（作者网站）
指向作者个人主页或组织官网的链接。
Tags（标签）
用英文逗号分隔的主题功能标签。这些标签帮助用户在后台按功能筛选主题。如果你要提交到官方主题库，需要参考官方认可的标签列表。
Text Domain（文本域名）
这是用于翻译的字符串标识符。它通常与主题文件夹名称一致（全部小写，用连字符代替空格）。WordPress通过这个标识符来加载对应的语言文件。
Domain Path（语言文件路径）
告诉WordPress去哪里找翻译文件。这是一个相对路径，相对于主题根目录。如果没有特别指定，默认是/languages文件夹。
Tested up to（高测试版本）
你测试过主题能够正常工作的新WordPress版本号。当用户使用的WordPress版本高于此数值时，后台会显示“未经过测试”的警告。
Requires at least（低WordPress版本要求）
主题能够正常工作的低WordPress版本号。如果用户WordPress版本过低，系统会阻止安装并给出提示。
Requires PHP（低PHP版本要求）
主题能够正常工作的低PHP版本号。使用PHP 8.x的新特性时，别忘了设置这个字段，避免在老旧服务器环境上引发兼容性问题。
License（许可证）
声明主题的开源许可证类型。绝大多数WordPress主题都采用GPL或兼容的许可证。官方主题库要求必须为GPL v2或更高版本。
License URI（许可证链接）
指向许可证全文的网址。通常可以链接到开源许可证组织的官方页面。
四、子主题的特殊字段
如果你在开发一个子主题（Child Theme），即在现有主题基础上进行二次开发，那么你需要在头部声明Template（父主题模板）字段，指明父主题的文件夹名称。
假设上面的“落日晚霞”是父主题，它的文件夹名称是luoriwanxia。那么子主题的头部应该是这样的：
css
/** * Theme Name: 朝霞满天 * Template: luoriwanxia * ...其他头部字段 */
Template字段的值必须与父主题的文件夹名称完全一致（大小写敏感），否则WordPress无法正确建立父子关系，子主题将无法正常工作。
五、关于自定义字段
有些三方平台或商业主题系统会自己定义额外的字段，例如Product ID、Update URI等。WordPress本身不处理这些自定义字段，但它们不会影响主题在WordPress中的正常使用，所以加进去是无害的。如果你只是在WordPress官方生态内开发，这些字段基本用不到。
六、关于样式代码的补充说明
请记住，头部注释区的“配置信息”只是style.css文件的前奏。在其之后，你仍然可以放心地编写大量的CSS代码。对于经典主题（Classic Theme），这通常是样式的主要来源；对于区块主题，样式更多由theme.json控制，但style.css依然可以作为补充样式的手段，例如添加一些无法通过theme.json实现的特殊效果。
总结
style.css是WordPress主题的“注册入口”和样式载体。它的头部注释区通过标准的键值对字段，向WordPress告知主题的身份、兼容性、版权等关键信息，其中“Theme Name”是必须的字段。子主题开发时，需要额外添加“Template”字段指向父主题文件夹。在实际开发中，除了配置好这些字段，你还需要在style.css中编写或引入样式代码，但现代区块主题开发中样式管理逐渐转向theme.json，这是你需要留意的趋势。
后，不要忘了style.css必须放在主题根目录下，且文件名必须是style.css。只要把握住“头部配置+样式代码”的二元结构，你就能轻松驾驭这个文件了。