wordpress 子主题中 `functions.php` 修改无效，通常源于函数名与 `add_action()` 中引用的名称不一致、钩子优先级设置不当或未正确加载父主题样式，本文将系统排查并修复此类问题。
在 WordPress 开发中，子主题（Child Theme）是安全定制父主题外观与功能的标准实践。但许多开发者在首次编写 functions.php 时会遇到“修改完全不生效”的情况——页面无变化、自定义样式丢失、JS 不加载等。你提供的 Wr Nitro 子主题示例正体现了典型错误：
function wr_nitro_child_enqueue_scripts(){
wp_enqueue_style('wr-nitro-child-style', get_stylesheet_directory_uri() . '/style.css');
}
add_action('wp_enqueue_scripts', 'wr-nitro_child_enqueue_scripts', 1000000000 );⚠️ 关键错误定位：
函数声明名为 wr_nitro_child_enqueue_scripts（使用下划线 _），但在 add_action() 中却传入 'wr-nitro_child_enqueue_scripts'（误用短横线 -）。PHP 将其视为完全不同的函数名，导致钩子注册失败，函数从未执行。
✅ 正确写法应严格统一命名（推荐下划线风格，符合 WordPress 编码规范）：
function wr_nitro_child_enqueue_scripts() {
// 1. 先加载父主题样式（必须！否则子主题 CSS 可能覆盖失效）
wp_enqueue_style(
'wr-nitro-parent-style',
get_template_directory_uri() . '/style.css'
);
// 2. 再加载子主题样式（可选：若需覆盖父主题规则）
wp_enqueue_style(
'wr-nitro-child-style',
get_stylesheet_directory_uri() . '/style.css',
array('wr-nitro-parent-style'), // 依赖父主题样式，确保加载顺序
filemtime(get_stylesheet_directory() . '/style.css') // 启用版本控制，避免缓存
);
}
add_action('wp_enqueue_scripts', 'wr_nitro_child_enqueue_scripts', 10); // 优先级无需极端值，10 即默认且稳妥? 重要补充说明：
- ✅ get_template_directory_uri() 获取父主题路径（Wr Nitro 主题所在目录）；
- ✅ get_stylesheet_directory_uri() 获取子主题路径（当前子主题目录）；
- ✅ 子主题 style.css 必须通过 @import 或 wp_enqueue_style() 显式引入，不能仅靠文件存在；
- ✅ 避免使用过高的优先级（如 1000000000），易引发兼容性问题；标准范围为 1–99，10 是推荐值；
- ✅ 启用 filemtime() 作为版本号，可强制浏览器更新 CSS，解决“改了却不显示”的缓存幻觉；
- ✅ 务必检查子主题 style.css 文件头部是否包含正确注释（含 Template: wr-nitro），否则 WordPress 不识别为有效子主题。
? 终极验证步骤：
- 检查 WordPress 后台 → 外观 → 主题，确认子主题已启用且状态为“已激活”；
- 查看浏览器开发者工具（F12）→ Network 标签页，筛选 style.css，确认子主题 CSS 已成功加载；
- 在 functions.php 顶部临时添加 error_log('Child theme functions loaded');，然后查看 PHP 错误日志，验证文件是否被解析。
遵循以上规范，90% 的子主题加载失败问题可立即解决。记住：函数名一致性 > 优先级数值 > 缓存清理——代码健壮性永远始于细节严谨。
