为何禁用WooCommerce后台功能的代码未生效？

我在Hello子主题的functions.php中使用以下代码尝试禁用指定WooCommerce后台功能，但仍能看到目标后台内容：

<?php
add_filter('woocommerce_admin_features', 'disable_woocommerce_features');
function disable_woocommerce_features($features) {

    $disable = array(
        'product-block-editor',
        'onboarding',
        'onboarding-tasks',
        'experimental-fashion-sample-products'
    );

    return array_diff($features, $disable);
}

核心原因及对应解决方案 #

• 目标功能不受woocommerce_admin_features过滤项管控
  这个过滤函数仅针对WooCommerce官方定义为"admin features"的特定模块，你截图中的内容大概率属于其他范畴——比如默认后台菜单、统计面板，或是第三方扩展新增的内容。需要先定位要禁用内容的具体钩子或标识，再使用对应的方法（比如remove_menu_page移除菜单，或针对特定扩展的过滤项）。

• 代码执行优先级不足
  部分WooCommerce功能可能在你的过滤函数执行前就完成了加载。可以给add_filter设置更高优先级（第三个参数设为999，数值越大执行越晚），确保你的规则能覆盖默认设置：

  add_filter('woocommerce_admin_features', 'disable_woocommerce_features', 999);
  

• 缓存残留导致修改未生效
  清理WordPress后台缓存、浏览器本地缓存，以及服务器端的缓存（如Redis、CDN缓存），确保新代码的逻辑被正确加载。

• 子主题代码未正常执行
  确认Hello子主题已激活，检查functions.php是否存在语法错误（比如重复的<?php标签、括号不匹配等）。可以临时添加日志代码验证：

  error_log('WooCommerce feature filter executed');
  

  然后查看服务器错误日志，确认这段代码是否被执行。

• WooCommerce版本不兼容
  不同版本的WooCommerce对woocommerce_admin_features支持的功能标识可能有变更。比如旧版本可能不支持部分新标识，新版本可能已修改标识名称。核对当前WooCommerce版本的官方文档，确认你使用的标识是否仍有效。

内容的提问来源于stack exchange，提问作者Lucien Dubois