wordpress子主题中`functions.php`文件修改无效，通常因函数名与`add_action`中引用名不一致、钩子优先级设置不当或未正确引入父主题样式导致。本文将详解典型错误及规范写法。
在使用 Wr Nitro 等商业主题开发子主题时，一个高频却极易被忽视的错误是：函数声明名与 add_action() 中传入的回调函数名不一致。您提供的代码中存在明显拼写差异：
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 ); // 连字符命名 ❌⚠️ 注意：PHP 函数名严格区分字符——wr_nitro_child_enqueue_scripts（下划线） ≠ wr-nitro_child_enqueue_scripts（含连字符）。后者根本不是合法函数名（PHP 不允许函数名含 -），导致 WordPress 无法找到并执行该回调，因此您的样式不会加载。
✅ 正确写法应保持完全一致，并遵循 WordPress 子主题最佳实践：
<?php
// functions.php（子主题根目录下）
function wr_nitro_child_enqueue_scripts() {
// 1. 先加载父主题样式（确保继承基础样式）
wp_enqueue_style( 'wr-nitro-style', get_template_directory_uri() . '/style.css' );
// 2. 再加载子主题样式（覆盖或扩展）
wp_enqueue_style( 'wr-nitro-child-style', get_stylesheet_directory_uri() . '/style.css', array('wr-nitro-style') );
}
add_action( 'wp_enqueue_scripts', 'wr_nitro_child_enqueue_scripts', 15 ); // 优先级15足够，无需超大数值? 关键要点说明：
- 命名一致性：函数名、add_action 第二参数、钩子回调必须一字不差（推荐全程复制粘贴，避免手误）；
- 依赖声明：子主题样式应声明 array('wr-nitro-style') 作为依赖，确保父主题样式先加载；
- 优先级合理化：1000000000 是冗余且无意义的——wp_enqueue_scripts 默认优先级为 10，子主题通常设为 15 即可安全覆盖；
- 必需的 ：确保 functions.php 以
- 勿重复加载 style.css：子主题 style.css 应仅包含主题元信息（Theme Name、Template 等），实际样式建议另建 assets/css/custom.css 并单独引入，避免与主题自动加载逻辑冲突。
最后，请确认：
- 子主题已在 WordPress 后台 > 外观 > 主题中启用（而非仅上传）；
- 服务器无 OPcache 或对象缓存插件（如 WP Rocket、Redis）未刷新导致旧代码残留；
- 浏览器开发者工具（Network 标签页）检查是否成功加载了子主题 CSS 文件及 HTTP 状态码。
遵循以上规范，即可彻底解决子主题样式不更新问题，保障定制开发稳定可靠。
