求助：WordPress短代码在文章编辑器中直接显示为文本无法解析

碰到这种情况挺闹心的——明明短代码直接用do_shortcode()能正常运行，放到文章编辑器里就变成纯文本输出了。别慌，咱们一步步排查解决：

1. 主题或插件移除了短代码解析钩子 #

WordPress默认会通过do_shortcode钩子自动解析the_content()里的短代码，但有些主题或插件可能会用remove_filter('the_content', 'do_shortcode');把这个核心钩子删掉，导致短代码无法被解析。

解决方法：

• 打开主题的functions.php文件，搜索是否存在上述代码，有的话直接注释或删除即可。
• 怀疑是插件冲突的话，先暂时禁用所有插件，测试短代码是否恢复正常解析。如果正常了，再逐个启用插件，找到冲突的那个，要么更新插件版本，要么更换替代插件。

2. 文章内容里的短代码被转义了 #

有时候在编辑器可视化模式下编辑，或者复制粘贴内容时，短代码的[和]会被自动转成HTML实体（比如[和]），这样前端就只会显示纯文本，不会触发解析逻辑。

解决方法：

• 切换到文章编辑器的「文本」模式（而非可视化模式），检查短代码的符号是不是正常的[和]，如果是转义后的实体，手动修改回正常符号即可。

3. 强制让the_content()解析短代码 #

如果上面的方法都没效果，咱们可以手动给the_content()加回短代码解析能力：

方案A：修改内容输出代码 #

把你当前的代码：

<?php the_content();?>

替换成：

<?php echo do_shortcode(apply_filters('the_content', get_the_content()));?>

这样既保留了the_content()自带的过滤效果（比如自动生成段落、图片样式处理等），又强制解析了短代码。

方案B：重新添加解析钩子 #

在主题的functions.php文件中添加以下代码，强制把短代码解析钩子加回去：

add_filter('the_content', 'do_shortcode', 11);

这里设置优先级为11，确保它在其他内容过滤逻辑之后执行，避免被其他函数覆盖。

4. 确认短代码的注册时机（概率较低） #

虽然你提到直接调用do_shortcode()能生效，但还是可以确认下短代码的注册逻辑——正常的短代码应该在init钩子完成注册，示例如下：

add_action('init', 'register_my_gallery_shortcode');
function register_my_gallery_shortcode() {
    add_shortcode('my_gallery', 'my_gallery_render_function');
}
function my_gallery_render_function($atts) {
    // 你的图库短代码逻辑
}

如果注册时机太晚，也可能导致the_content()无法识别（不过你直接调用能跑的话，这个情况概率很低）。

内容的提问来源于stack exchange，提问作者MrO