在 WooCommerce 主题或子主题中，is_product_category()、is_product_tag() 等条件函数若在错误的执行时机（如未挂载到合适钩子）直接调用，将始终返回 false，导致分类/标签判断失效。
在 woocommerce 主题或子主题中，`is_product_category()`、`is_product_tag()` 等条件函数若在错误的执行时机（如未挂载到合适钩子）直接调用，将始终返回 `false`，导致分类/标签判断失效。
在 WooCommerce 开发中，准确判断当前是否处于某产品分类页（如 test-cat）或标签页（如 test-tag），是实现页面定制、内容过滤或功能开关的关键。但许多开发者会遇到类似以下代码“完全不生效”的问题：
// ❌ 错误示例：在 functions.php 顶层直接执行（非钩子内）
if (is_product_category('test-cat')) {
echo '<h1>BLA</h1>';
}
这类代码必然失效——因为 WordPress 在 functions.php 加载阶段尚未完成主查询（WP_Query）初始化，is_product_category() 等模板条件函数依赖于已构建完毕的全局 $wp_query 对象，此时调用将一律返回 false。
✅ 正确做法是：将条件逻辑挂载到 WordPress 已完成主查询的钩子上，最常用且安全的是 template_redirect（适用于所有前端页面）或更精准的 woocommerce_before_main_content（仅 WooCommerce 页面）：
// ✅ 正确示例：在合适的钩子中执行条件判断
add_action('template_redirect', 'check_product_category_or_tag');
function check_product_category_or_tag() {
// 判断是否为指定产品分类页
if (is_product_category('test-cat')) {
error_log('当前是 test-cat 分类页'); // 推荐用日志调试
// do_something();
}
// 判断是否为指定产品标签页
if (is_product_tag('test-tag')) {
error_log('当前是 test-tag 标签页');
// do_something();
}
// 判断当前产品（需在单产品页上下文）是否含有某分类或标签
if (is_product()) {
global $post;
if (has_term('test-cat', 'product_cat', $post->ID)) {
error_log('当前产品属于 test-cat 分类');
}
if (has_term('test-tag', 'product_tag', $post->ID)) {
error_log('当前产品带有 test-tag 标签');
}
}
}
⚠️ 关键注意事项：
-
has_term($term, $taxonomy, $post_id)的第三个参数 必须显式传入产品 ID（如$post->ID），否则默认检查当前主循环对象（可能为空或非产品）； -
is_tax('product_cat', 'test-cat')语法不推荐：is_tax()第二个参数应为数组或省略，正确写法是is_tax('product_cat') && is_product_category('test-cat')或直接用is_product_category()； - 避免在
init、wp或after_setup_theme等早期钩子中调用模板条件函数； - 调试建议：使用
error_log()+wp_get_referer()或浏览器开发者工具 Network 面板确认请求 URL 是否匹配预期分类/标签归档页。
总结：WooCommerce 条件函数不是“即时可用”的布尔表达式，而是依赖主查询状态的运行时判断工具。务必将其置于 template_redirect 或 woocommerce_before_main_content 等可靠钩子中，并确保上下文（如是否在单产品页）与函数用途一致——这才是解决 has_term、is_product_category 等函数“不工作”问题的根本方法。
