在function.php中调用do_shortcode时，需确保获取的是返回值而非直接输出（如the_field会直接echo），且钩子回调函数应适配其参数机制；错误使用会导致短代码无法解析。

在WordPress主题开发中，常需在WooCommerce商品页插入自定义短代码（例如由Advanced Custom Fields（ACF）字段存储的[banner]或[product_gallery]）。但许多开发者会误用the_field()与do_shortcode()组合，导致短代码无法渲染——根本原因在于：the_field()是直接输出函数（类似echo），而do_shortcode()需要接收字符串作为参数，不能处理已输出的内容。

你原始代码的问题有三处：

1. the_field('product_tree') 直接输出字段内容，返回值为null，赋值给$field后实际传入do_shortcode(null)；
2. echo do_shortcode($field) 在非输出上下文中（如钩子回调）可能被缓冲或拦截，尤其当主题/插件启用了输出缓冲时；
3. woocommerce_after_single_product_summary 钩子的默认回调函数不接收参数，你添加的$result形参不会被自动传入，因此原修复方案中的参数写法存在逻辑缺陷（该钩子本身不传递参数，不应依赖$result返回值）。

✅ 正确做法如下：

HR面试评价助手-Word版

🎯 HR面试评价助手（Word版格式） 生成可直接复制到Word文档的标准格式HR面试评价 【使用方式】 1. 发送口令：HR面试评价 2. 粘贴JD文字 3. 上传简历文档 4. 上传面试记录（可选） 5. 复制生成的评价到Word 【输出特点】 - 纯文本格式，可直接粘贴到Word - 层次清晰，标题加粗...

下载

• 使用 get_field('product_tree', $post_id) 获取字段字符串值（非输出）；
• 显式传入当前商品ID（get_the_ID()），确保ACF从正确上下文读取数据；
• 直接 echo do_shortcode(...) —— 因为该钩子设计用于向页面注入HTML，允许且预期执行输出。

add_action('woocommerce_after_single_product_summary', 'custom_single_product_banner', 12);
function custom_single_product_banner() {
    $post_id = get_the_ID();
    $shortcode_content = get_field('product_tree', $post_id);

    // 安全检查：仅当字段存在且非空时执行
    if ($shortcode_content && is_string($shortcode_content)) {
        echo do_shortcode($shortcode_content);
    }
}

⚠️ 注意事项：

• 不要混淆 the_field()（输出）和 get_field()（返回）——后者才是do_shortcode()的正确输入源；
• 确保ACF字段类型为“文本”或“富文本”，且内容为合法短代码格式（如[my_custom_banner title="Sale!"]）；
• 若短代码内含PHP逻辑或动态数据，请确认对应插件已激活，且短代码函数已通过add_shortcode()注册；
• 如需过滤或调试，可临时添加 error_log('Shortcode: ' . $shortcode_content); 查看实际传入值。

总结：do_shortcode()本身完全支持在functions.php中使用，关键在于数据来源必须是可计算的字符串，而非已输出的流。遵循“获取→判断→解析→输出”四步流程，即可稳定实现短代码在WooCommerce钩子中的动态渲染。