嘿，大家好！我是你们今天的“主题公园”导游，专门带大家玩转WordPress主题的两个核心函数：get_stylesheet_directory() 和 get_template_directory()。准备好开启一场源码探险之旅了吗？
第一站：认识我们的主角
在开始深入源码之前，我们先来简单认识一下这两位主角：
-
get_stylesheet_directory(): 想象一下，你的网站穿了一件非常漂亮的“样式外套”，这件外套就是你的CSS样式表。这个函数的作用就是找到这件“外套”存放的文件夹的完整路径。对于主主题，它指向主主题的目录；对于子主题，它指向子主题的目录。 -
get_template_directory(): 这玩意儿有点像你网站的“骨架”，定义了网站的基本结构和功能。这个函数的作用是找到存放这些“骨架”文件（也就是主主题文件）的文件夹的完整路径。无论你是在主主题还是子主题中使用，它永远指向主主题的目录。
第二站：get_stylesheet_directory() 源码解剖
好的，让我们直接进入源码世界。get_stylesheet_directory()函数的定义通常位于 wp-includes/theme.php 文件中（具体位置可能会因WordPress版本而略有差异）。
function get_stylesheet_directory() {
/**
* Filters the stylesheet directory URI.
*
* @since 1.5.0
*
* @param string $stylesheet_dir URI to the stylesheet directory.
* @param string $stylesheet Stylesheet name.
*/
return apply_filters( 'stylesheet_directory', get_theme_root() . '/' . get_stylesheet(), get_stylesheet() );
}看起来很简单，不是吗？ 但别被它的简洁外表迷惑了，这里面包含了几个关键步骤：
-
get_theme_root(): 这个函数负责找到主题根目录的绝对路径。 你可以把它想象成一个“主题总部”，所有主题都存放在这个总部里。function get_theme_root() { $theme_root = WP_CONTENT_DIR . '/themes'; /** * Filters the absolute path to themes directory. * * @since 2.1.0 * * @param string $theme_root Absolute path to themes directory. */ return apply_filters( 'theme_root', $theme_root ); }WP_CONTENT_DIR是一个定义在wp-config.php文件中的常量，它指向你的 WordPress 内容目录（通常是wp-content）。get_theme_root()只是简单地将WP_CONTENT_DIR和/themes拼接起来，然后应用一个名为theme_root的过滤器。这意味着你可以通过这个过滤器来改变主题的根目录（虽然通常情况下你不会这么做）。 -
get_stylesheet(): 这个函数返回当前使用的样式表（stylesheet）的名称。 如果你的网站使用主主题，它返回主主题的名称；如果使用子主题，它返回子主题的名称。function get_stylesheet() { $stylesheet = get_option( 'stylesheet' ); /** * Filters the name of the current stylesheet. * * @since 1.5.0 * * @param string $stylesheet Name of the stylesheet. */ return apply_filters( 'stylesheet', $stylesheet ); }这个函数从 WordPress 数据库的
wp_options表中获取stylesheet选项的值。 这个选项记录了当前网站使用的样式表的名称。 同样，它也应用了一个名为stylesheet的过滤器，允许你修改样式表的名称。 -
拼接和过滤:
get_stylesheet_directory()函数将get_theme_root()返回的路径、一个斜杠/和get_stylesheet()返回的样式表名称拼接起来，形成完整的样式表目录路径。 最后，它应用一个名为stylesheet_directory的过滤器，允许你修改样式表目录的路径。
重点：子主题中的 get_stylesheet_directory()
当你在子主题中使用 get_stylesheet_directory() 时，它会返回子主题的目录路径。 这是因为 get_stylesheet() 函数会返回子主题的名称，从而导致最终的路径指向子主题的目录。
第三站：get_template_directory() 源码剖析
现在，让我们来看看 get_template_directory() 的源码：
function get_template_directory() {
/**
* Filters the template directory URI.
*
* @since 1.5.0
*
* @param string $template_dir URI to the template directory.
* @param string $template Template name.
*/
return apply_filters( 'template_directory', get_theme_root() . '/' . get_template(), get_template() );
}是不是感觉似曾相识？ 它和 get_stylesheet_directory() 的结构几乎一模一样！ 唯一的区别在于它使用了 get_template() 函数而不是 get_stylesheet() 函数。
-
get_template(): 这个函数返回当前使用的模板（template）的名称，也就是主主题的名称。function get_template() { $template = get_option( 'template' ); /** * Filters the name of the current template. * * @since 1.5.0 * * @param string $template Name of the template. */ return apply_filters( 'template', $template ); }和
get_stylesheet()类似，它从wp_options表中获取template选项的值。 这个选项记录了当前网站使用的主题的名称。 同样，它也应用了一个名为template的过滤器。 -
拼接和过滤:
get_template_directory()函数将get_theme_root()返回的路径、一个斜杠/和get_template()返回的模板名称拼接起来，形成完整的模板目录路径。 最后，它应用一个名为template_directory的过滤器，允许你修改模板目录的路径。
重点：子主题中的 get_template_directory()
关键来了！ 即使你在子主题中使用 get_template_directory()，它仍然会返回主主题的目录路径。 这是因为 get_template() 函数始终返回主主题的名称，无论你当前使用的是主主题还是子主题。
第四站：子主题开发中的应用场景
现在，我们来讨论一下这两个函数在子主题开发中的实际应用：
1. 加载资源文件：
-
get_stylesheet_directory_uri(): 这个函数返回子主题的样式表目录的URL。在子主题中，当你需要加载子主题自己的CSS、JavaScript、图片等资源文件时，你会用到这个函数。// 在子主题的 functions.php 文件中加载子主题的 CSS 文件 function my_child_theme_enqueue_styles() { wp_enqueue_style( 'my-child-theme-style', get_stylesheet_directory_uri() . '/style.css' ); } add_action( 'wp_enqueue_scripts', 'my_child_theme_enqueue_styles' ); // 在子主题的某个模板文件中加载子主题的 JavaScript 文件 <script src="<?php echo get_stylesheet_directory_uri(); ?>/js/my-script.js"></script> -
get_template_directory_uri(): 这个函数返回主主题的目录的URL。 在子主题中，如果你需要加载主主题的资源文件，可以使用这个函数。 但是，通常情况下，你更应该利用 WordPress 的主题继承机制，避免直接加载主主题的资源文件。// 强烈建议：尽量避免直接加载主主题的资源文件 // 除非你非常清楚自己在做什么 // 例如：你想加载主主题的某个图片 <img src="<?php echo get_template_directory_uri(); ?>/images/logo.png" alt="Logo">
2. 覆盖主主题的模板文件：
子主题的核心功能之一就是覆盖主主题的模板文件。 当你需要在子主题中修改主主题的某个模板文件时，你只需要在子主题中创建一个与主主题相同路径和文件名的文件，WordPress 就会优先加载子主题中的文件。
```
// 主题目录结构：
// - wp-content
// - themes
// - parent-theme (主主题)
// - index.php
// - single.php
// - child-theme (子主题)
// - index.php (覆盖主主题的 index.php)
```
在这种情况下，当你访问网站首页时，WordPress 会加载子主题中的 `index.php` 文件，而不是主主题中的 `index.php` 文件。3. 包含主主题的模板文件：
有时候，你可能需要在子主题中包含主主题的某个模板文件。 这时，你可以使用 `get_template_part()` 函数，并结合 `get_template_directory()` 函数来实现。
```php
// 在子主题的某个模板文件中包含主主题的 header.php 文件
get_template_part( get_template_directory() . '/header' );
// 更推荐的写法：使用 get_template_part() 的标准用法
// 这样 WordPress 会自动查找子主题中是否存在 header.php 文件
// 如果不存在，则加载主主题中的 header.php 文件
get_template_part( 'header' );
```
注意：更推荐使用 `get_template_part('header');` 这种写法，这样WordPress会先在子主题中查找 `header.php` 文件，如果找不到，才会去主主题中查找。 这样可以更好地利用 WordPress 的主题继承机制。4. 动态生成路径：
这两个函数可以帮助你动态生成文件路径，例如在包含文件、加载资源时。
```php
// 包含主主题的某个函数文件
require_once get_template_directory() . '/includes/functions.php';
// 加载子主题的某个配置文件
require_once get_stylesheet_directory() . '/config.php';
```第五站：代码示例和注意事项
为了更好地理解这两个函数，我们来看一些具体的代码示例：
示例 1：在子主题的 functions.php 文件中加载 CSS 文件
function my_child_theme_enqueue_styles() {
$parent_style = 'parent-style'; // 这是主主题的 style.css 的句柄
wp_enqueue_style( $parent_style, get_template_directory_uri() . '/style.css' );
wp_enqueue_style( 'child-style',
get_stylesheet_directory_uri() . '/style.css',
array( $parent_style ),
wp_get_theme()->get('Version')
);
}
add_action( 'wp_enqueue_scripts', 'my_child_theme_enqueue_styles' );这段代码首先加载主主题的 style.css 文件，然后加载子主题的 style.css 文件。 注意，我们将主主题的 style.css 文件的句柄作为子主题 style.css 文件的依赖项，这样可以确保主主题的 CSS 文件先加载，子主题的 CSS 文件后加载，从而覆盖主主题的样式。
示例 2：在子主题的模板文件中包含主主题的 header.php 文件
<?php get_template_part( 'header' ); ?>这段代码会先在子主题中查找 header.php 文件，如果找不到，则加载主主题中的 header.php 文件。
示例 3：调试输出路径
echo '主主题目录：' . get_template_directory() . '<br>';
echo '子主题目录：' . get_stylesheet_directory() . '<br>';将这段代码添加到你的主题文件中，可以帮助你查看这两个函数返回的路径，以便更好地理解它们的作用。
注意事项：
- 不要硬编码路径： 尽量使用
get_stylesheet_directory()和get_template_directory()函数来动态生成路径，避免硬编码路径。 这样可以使你的代码更具可移植性和可维护性。 - 理解主题继承机制： 充分利用 WordPress 的主题继承机制，避免不必要的代码重复。 例如，如果子主题只需要修改主主题的某个样式，只需要在子主题的
style.css文件中覆盖相应的样式即可，不需要复制整个主主题的style.css文件。 - 谨慎修改主主题文件： 尽量不要直接修改主主题的文件。 所有修改都应该在子主题中进行。 这样可以避免在主主题更新时丢失你的修改。
- *使用 `_uri()
函数获取 URL：** 如果需要获取目录的 URL，而不是绝对路径，请使用get_stylesheet_directory_uri()和get_template_directory_uri()` 函数。 - 了解过滤器： 这两个函数都应用了过滤器。 你可以使用这些过滤器来修改它们的返回值，以满足你的特定需求。 但是，除非你有充分的理由，否则不建议修改这些函数的返回值。
第六站：总结
get_stylesheet_directory() 和 get_template_directory() 是 WordPress 主题开发中非常重要的两个函数。 理解它们的作用和源码，可以帮助你更好地进行子主题开发，并编写出更具可移植性和可维护性的代码。
希望今天的源码探险之旅对你有所帮助！ 下次再见！