在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()需要接收字符串作为参数，不能处理已输出的内容。
你原始代码的问题有三处：
- the_field('product_tree') 直接输出字段内容，返回值为null，赋值给$field后实际传入do_shortcode(null)；
- echo do_shortcode($field) 在非输出上下文中（如钩子回调）可能被缓冲或拦截，尤其当主题/插件启用了输出缓冲时；
- woocommerce_after_single_product_summary 钩子的默认回调函数不接收参数，你添加的$result形参不会被自动传入，因此原修复方案中的参数写法存在逻辑缺陷（该钩子本身不传递参数，不应依赖$result返回值）。
✅ 正确做法如下：
- 使用 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钩子中的动态渲染。
