WordPress WooCommerce 如何在header.php中获取商品完整数据

之前代码失效的核心原因有两点：

1. 加载顺序问题：WordPress的header.php会在全局主查询（wp_query）执行完成前加载，此时WooCommerce尚未完成全局商品对象（$product）的初始化，直接调用global $product根本拿不到标准的WC_Product类实例。
2. 变量污染问题：你调试时拿到的string(6) "hoodie"，本质是其他主题/插件代码提前把零散的商品名字符串赋值给了全局$product变量，没有走WooCommerce标准的对象实例化流程，自然无法读取价格、SKU等结构化字段。

核心实现逻辑 #

因为header.php是全站公共模板，仅在用户访问单个商品详情页时才有对应商品的上下文，不能在所有页面强行拉取商品数据，否则会触发无效报错。

• 先判断当前页面是否为WooCommerce商品详情页
• 手动从全局查询中提取当前商品的ID
• 通过WooCommerce官方提供的wc_get_product()方法实例化标准商品对象，不依赖未初始化的全局变量
• 校验对象有效性后读取对应字段渲染到页面

可直接复用的代码示例 #

把以下代码放到header.php中需要展示商品信息的位置即可：

// 判断WooCommerce是否启用、当前是否为单个商品详情页
if ( function_exists( 'is_product' ) && is_product() ) {
    global $wp_query;
    // 从全局主查询中获取当前商品的ID
    $product_id = $wp_query->get_queried_object_id();

    // 校验ID有效性，避免无效ID触发报错
    if ( $product_id && get_post_type( $product_id ) === 'product' ) {
        // 实例化标准WooCommerce商品对象
        $current_product = wc_get_product( $product_id );

        // 校验对象可用性后读取核心字段
        if ( $current_product ) {
            $product_name = $current_product->get_name();
            $product_price_html = $current_product->get_price_html();
            $product_sku = $current_product->get_sku();

            // 渲染展示（所有输出做安全转义）
            echo '<div class="header-product-meta">';
            echo '<span class="product-name">' . esc_html( $product_name ) . '</span>';
            echo '<span class="product-price">' . wp_kses_post( $product_price_html ) . '</span>';
            echo '<span class="product-sku">SKU: ' . esc_html( $product_sku ) . '</span>';
            echo '</div>';
        }
    }
}

更稳妥的优化方案 #

如果不想把业务逻辑直接写在header.php文件中，可以把这部分渲染逻辑挂载到wp动作钩子上——这个钩子触发时，WordPress已经完成了全局主查询的执行，完全不存在加载顺序导致的变量未就绪问题：

add_action( 'wp', function() {
    if ( function_exists( 'is_product' ) && is_product() ) {
        // 把上面的商品获取、渲染逻辑放在这里
    }
} );

常见避坑提示 #

• 不要在header.php的文件最开头、全局查询执行前直接读取全局$product变量，WooCommerce的全局商品对象仅在商品循环、商品详情页的内容渲染阶段才会完成初始化。
• 不要依赖其他插件/主题提前赋值的全局变量，所有WooCommerce商品对象都必须通过wc_get_product()方法实例化，才能拿到完整的价格、SKU、库存等结构化字段。
• 所有输出到前端页面的字段都要做安全转义处理，避免XSS安全风险。

内容的提问来源于stack exchange，提问作者Linh Nguyễn