WordPress子主题创建教程

1. 先整明白为啥要用子主题吧。你想啊，WordPress主题更新了，你要是直接改父主题代码，下次更新全白给——子主题就是你的私人保险箱，自定义代码放里头，父主题随便升级都不怕。说白了就是“代码隔离”的高级玩法，既安全又灵活。

2. 准备工作：找个代码编辑器（VS Code或Notepad++都行），再备个FTP工具（FileZilla免费好用）。对了，操作前记得备份网站！万一手滑了还能救回来。

3. 创建子主题文件夹：在/wp-content/themes/目录下新建文件夹，名字随便但要有辨识度，比如用父主题名加"-child"后缀。假设父主题是"twentytwentyfour"，那就建个"twentytwentyfour-child"文件夹。

4. 必须有的文件就两个！先搞style.css：在子主题文件夹里新建这个文件，头部注释一定要写清楚，不然后台不识别。代码长这样：

/*
Theme Name: Twenty Twenty-Four Child
Theme URI: https://example.com/
Description: 基于Twenty Twenty-Four的子主题
Template: twentytwentytwo-four
Version: 1.0
Author: 你的名字
*/

/* 下面引入父主题样式表 */
@import url("../twentytwentyfour/style.css");

/* 你的自定义CSS从这里开始 */
body {
    font-size: 18px; /* 比如调大全局字体 */
}

注意！Template字段必须写父主题的目录名，一个字母都不能错。

5. 第二个关键文件：functions.php。这个不是覆盖父主题的，而是追加代码用。开头别写<?php重复标签！直接写：

<?php
// 子主题的函数逻辑
add_action( 'wp_enqueue_scripts', 'my_child_theme_scripts' );
function my_child_theme_scripts() {
    // 正确加载父主题样式的方式
    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' ) );
}

6. 现在去WordPress后台→外观→主题，应该能看到你的子主题了。激活它！网站前台看起来应该和父主题一模一样——这就对了，说明继承成功了。

7. 进阶操作：覆盖父主题模板文件。比如想修改文章单页，就把父主题的single.php复制到子主题文件夹里直接改。WordPress会优先调用子主题里的模板文件。改的时候最好保留父主题原有结构，只调整需要的部分。

8. 函数追加案例：比如想在文章末尾加个自定义内容：

add_filter( 'the_content', 'add_post_footer' );
function add_post_footer( $content ) {
    if ( is_single() ) {
        $content .= '<div class="a78d-1d03-4f87-f11d custom-footer">本文来自XXX网站</div>';
    }
    return $content;
}

9. 实际开发中经常要调用子主题目录路径：用get_stylesheet_directory_uri()获取子主题URL，用get_stylesheet_directory()获取服务器路径。别再用过时的bloginfo('stylesheet_directory')了。

10. 调试技巧：打开WP_DEBUG模式，修改wp-config.php文件：

    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_LOG', true ); // 错误日志存到wp-content/debug.log

    这样代码出错时能快速定位问题。

11. 完工后记得测试！特别是父主题更新后要检查子主题是否兼容。平时修改子主题建议用WordPress自定的Additional CSS功能处理简单样式，复杂修改再用子主题代码实现。

最后啰嗦句：别在子主题里放图片/js库等大文件，推荐用插件或者CDN处理资源加载。子主题要保持轻量化，只承载核心自定义功能才是正道。

Tags：

文章版权声明：除非注明，否则均为WP集市原创文章，转载或复制请以超链接形式并注明出处。