ACF Pro中acf/init钩子结合选项字段与短码的问题排查求助

大家好，我来帮你拆解下这个问题的核心原因，以及对应的解决办法！

首先说导致短码无输出的直接问题：变量作用域错误。你在acf/init的匿名函数里定义的$bulletin_text是局部变量，并没有被声明为全局变量——虽然短码函数里写了global $bulletin_text，但这个全局变量根本没被正确初始化，所以短码函数返回的是null，自然前端看不到内容。

接下来逐个解答你的疑问：

1. acf/init钩子的使用是否正确？ #

这个钩子的使用方向完全正确！acf/init确实是ACF官方推荐的、用来确保ACF完全加载后，再执行依赖get_field等ACF函数的钩子，能有效避免call to undefined function get_field这类错误，你选这个钩子本身没毛病。

2. 选项字段在acf/init里处理有特殊之处吗？ #

完全没有特殊要求！只要ACF通过acf/init确认加载完成，get_field('字段名', 'option')这种选项字段的调用逻辑和普通字段完全一致，正常执行就能拿到值。

3. 短码的注册有问题吗？ #

短码的注册逻辑本身没问题，问题出在你对短码函数的变量依赖处理上——不是短码注册的锅，是变量作用域的错误导致拿不到值。

4. 使用全局变量$bulletin_text是不是坏主意？ #

是的，非常不推荐！全局变量很容易引发变量冲突（比如其他主题/插件也用了同名变量），还会让代码的可读性和可维护性变差，能不用就尽量不用。

给你的修正方案 #

这里提供两个更可靠的写法，都能解决你的问题：

方案一：直接在短码函数内调用get_field（推荐）

这个写法最简洁，还能保证每次调用短码都获取最新的选项值，同时彻底避免全局变量：

add_action('acf/init', function() {
    function show_shortcode_bulletin(){
        // 直接在短码执行时获取选项值，ACF已经确保加载完成
        return get_field('bulletin_text', 'option');
    }
    add_shortcode('bulletins', 'show_shortcode_bulletin');
});

ACF本身会对选项字段做缓存，所以不用担心多次调用get_field的性能问题，而且后台修改选项值后，前端刷新就能看到最新内容，比你之前一次性取值的写法更灵活。

方案二：用静态变量缓存值（适合选项值极少修改的场景）

如果确实想只获取一次值做缓存，可以用静态变量代替全局变量，作用域更安全：

add_action('acf/init', function() {
    function show_shortcode_bulletin(){
        // 静态变量只会在第一次调用时初始化
        static $bulletin_text = null;
        if (is_null($bulletin_text)) {
            $bulletin_text = get_field('bulletin_text', 'option');
        }
        return $bulletin_text;
    }
    add_shortcode('bulletins', 'show_shortcode_bulletin');
});

这个写法只会在第一次调用短码时获取选项值，之后都用缓存的内容，适合选项值几乎不会修改的场景。

最后再提一句：你之前遇到的call to undefined function get_field错误，已经通过把代码放到acf/init里解决了，现在的核心问题就是变量作用域导致的短码无输出，按照上面的方案修改后应该就能正常显示了！

内容来源于stack exchange