Skip to content

1.3 WordPress 核心目录结构

了解WordPress的目录结构是主题开发的基础,它有助于你理解文件的组织方式和各部分的功能。WordPress的核心目录结构相对简单明了,主要包含以下几个重要目录:

WordPress 核心目录

1. wp-admin

wp-admin目录包含WordPress后台管理界面的所有文件,负责处理管理员的操作和设置。

  • 功能:提供WordPress后台管理界面
  • 内容:包含管理界面的PHP文件、CSS、JavaScript等
  • 注意:一般情况下,主题开发不需要修改此目录中的文件

2. wp-content

wp-content目录是WordPress中最重要的目录之一,它包含了用户生成的内容和第三方扩展。

子目录:

  • themes:存放WordPress主题的目录(重点)
  • plugins:存放WordPress插件的目录
  • uploads:存放上传的媒体文件(图片、视频等)
  • languages:存放语言包文件

3. wp-includes

wp-includes目录包含WordPress核心功能的文件,如函数库、类和核心API。

  • 功能:提供WordPress核心功能
  • 内容:包含核心函数、类、API等
  • 注意:不建议修改此目录中的文件,以免影响WordPress的正常运行

4. 根目录文件

WordPress根目录包含一些核心文件,如:

  • wp-config.php:WordPress配置文件,包含数据库连接信息等
  • index.php:WordPress入口文件
  • .htaccess:Apache服务器配置文件(用于URL重写)

重点:wp-content/themes 目录

wp-content/themes目录是我们主题开发的主要工作目录,所有的主题文件都存放在这里。

目录结构

每个主题在themes目录中都有自己独立的文件夹,例如:

wp-content/
└── themes/
    ├── twentytwentytwo/       # WordPress默认主题
    ├── my-custom-theme/        # 自定义主题
    └── child-theme/            # 子主题

主题文件夹命名规范

为你的主题选择一个合适的名称非常重要,遵循以下命名规范:

  • 小写字母:使用小写字母
  • 连字符:使用连字符(-)分隔单词,而不是下划线
  • 唯一性:确保名称与其他主题不冲突
  • 描述性:名称应能反映主题的特点或用途

示例

  • 好的命名:my-blog-themeportfolio-themebusiness-site
  • 不好的命名:MyTheme(使用了大写字母)、my_theme(使用了下划线)

主题文件结构

一个完整的WordPress主题通常包含以下文件:

核心文件

  • style.css:主题样式文件,包含主题信息头
  • index.php:默认模板文件
  • header.php:网站头部模板
  • footer.php:网站底部模板
  • functions.php:主题功能文件

可选文件

  • single.php:单篇文章模板
  • page.php:页面模板
  • archive.php:归档页面模板
  • category.php:分类页面模板
  • tag.php:标签页面模板
  • 404.php:404错误页面模板
  • search.php:搜索结果页面模板

资源目录

主题通常还包含以下资源目录:

  • assets/:存放静态资源
    • css/:CSS文件
    • js/:JavaScript文件
    • images/:图片文件
  • inc/:存放包含文件
  • template-parts/:存放模板部分文件

目录权限

在开发主题时,需要注意目录权限的设置:

  • 主题目录:通常设置为755
  • 文件:通常设置为644

这样可以确保WordPress能够正常访问和使用主题文件,同时保持一定的安全性。

小结

了解WordPress的核心目录结构,特别是wp-content/themes目录,是主题开发的基础。通过本章节的学习,你应该:

  1. 熟悉WordPress的整体目录结构
  2. 了解wp-content/themes目录的重要性
  3. 掌握主题文件夹的命名规范
  4. 了解主题文件的基本结构

在后续的章节中,我们将详细介绍如何在wp-content/themes目录中创建和开发自定义主题。

© 2026 编程马·菜鸟教程 版权所有