在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返回值）。
✅ 正确做法如下：
TURF(开源)权限管理系统
下载
TURF（开源）权限定制管理系统（以下简称“TURF系统”），是蓝水工作室推出的一套基于软件边界设计理念研发的具有可定制性的权限管理系统。TURF系统充分考虑了易用性，将配置、设定等操作进行了图形化设计，完全在web界面实现，程序员只需在所要控制的程序中简单调用一个函数，即可实现严格的程序权限管控，管控力度除可达到文件级别外，还可达到代码级别，即可精确控制到
- 使用 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钩子中的动态渲染。
