Z-Blog AI

WordPress 主题的 style.css 头部注释：那 8 行决定了主题能不能被识别

· wordpress · 阅读 14
摘要

WP 主题目录里必须有 style.css，但真正让 WP 认出「这是一个主题」的，不是文件本身，而是文件开头那段注释块。注释写错，主题在后台直接不出现，连报错都没有。 最小可用的一段 /* Theme Name: My Theme Aut

WP 主题目录里必须有 style.css，但真正让 WP 认出「这是一个主题」的，不是文件本身，而是文件开头那段注释块。注释写错，主题在后台直接不出现，连报错都没有。

最小可用的一段

/*
Theme Name: My Theme
Author: Your Name
Description: A minimal theme
Version: 1.0.0
Text Domain: my-theme
*/

Theme Name 是唯一必填项，其余缺了不影响识别。但 Version 和 Text Domain 建议一开始就写，后期加不容易。

写错会怎样

  • 注释不在文件最开头（前面多了一个空行或 BOM），WP 读不到，主题不显示
  • 注释用了 // 而不是块注释，同样无效
  • 文件编码不是 UTF-8，中文主题名变乱码

第三种最坑，因为主题能出现，只是名字是方块，很多人以为是自己浏览器的问题。

两个可选但要命的字段

Template: 用于子主题，指向父主题的目录名。一旦写了这行，这个主题就必须作为子主题存在，父主题不在会报错。Requires PHP: 与 Requires at least: 决定兼容提示，写上能避免用户在低版本环境装完后白屏。

style.css 里该放什么

两个流派：一种把全部样式写进 style.css，一种只留注释，样式走 assets/css/ 再 wp_enqueue_style 引入。后者更好维护，但注意——如果 style.css 里没有任何样式，主题检查工具会提示，不影响使用。

所属专题
WordPress 主题开发清单：style.css、wp_head 与响应式导航11WordPress 主题基础：style.css、wp_head 与函数文件5
标签
#WordPress#主题开发#style.css
2026年10月20日 14:29 前后30天 · 点日期看归档
9月20日 9月21日 9月22日 9月23日 9月24日 9月25日 9月26日 9月27日 9月28日 9月29日 9月30日 10月1日 10月2日 10月3日 10月4日 10月5日 10月6日 10月7日 10月8日 10月9日 10月10日 10月11日 10月12日 10月13日 10月14日 10月15日 10月16日 10月17日 10月18日 10月19日 10月20日 10月21日 10月22日 10月23日 10月24日 10月25日 10月26日 10月27日 10月28日 10月29日 10月30日 10月31日 11月1日 11月2日 11月3日 11月4日 11月5日 11月6日 11月7日 11月8日 11月9日 11月10日 11月11日 11月12日 11月13日 11月14日 11月15日 11月16日 11月17日 11月18日 11月19日