在WordPress中添加JSON-LD结构化数据主要有三种方法：使用专用插件(最省心)、手动添加到主题文件(更灵活)、或利用现有SEO插件功能。

方法一：使用专用插件(推荐，无需代码)

如果你的主要需求是快速、无代码地实现常见Schema类型，安装专用插件是最佳选择。以下是一些高质量的免费插件：

1.AgilePress Schema JSON-LD Block

这是一个Gutenberg区块插件，让你可以在编辑器侧边栏直接配置JSON-LD，支持文章/页面的动态占位符(如{{title}}、{{excerpt}})和ACF字段。

特点：提供本地商家、组织、FAQ等模板，实时验证JSON有效性，数据通过wp_head输出。

适用场景：习惯使用块编辑器、需要精细控制单篇文章Schema的用户。

2.Schema Guru

一个轻量级但功能全面的结构化数据插件，支持全局或单篇文章分配Schema类型。

支持的Schema类型：LocalBusiness、Product、Article、Job Posting、Event、Recipe、FAQ Page等。

特点：可以设置全局默认信息(如组织名称、Logo)，并为每篇文章单独设置，兼容AMP。

3.Structured Content (JSON-LD)

提供多种Gutenberg区块和经典编辑器短代码，方便在内容中插入特定类型的结构化数据。

支持类型：FAQPage、JobPosting、Recipe、Event、Course、Person等。

特点：可以选择仅输出JSON-LD，或以可见HTML + JSON-LD的方式呈现。

4.DataStackLogic Schema Manager

专注于Organization和LocalBusiness的核心Schema输出，同时提供强大的FAQ管理和AI爬虫控制功能。

特点：可批量导入FAQ，支持一键配置针对GPTBot、ClaudeBot等15种AI爬虫的访问规则。

适用场景：对本地商家SEO和AI搜索引擎优化有较高需求的站点。

5.Pointalize FAQ Markup

一个“零配置”的插件，专门用于FAQ页面。

工作原理：只需在文章/页面中使用WordPress自带的“Details”区块(或任何HTML标签)创建FAQ，插件会自动检测并生成合法的FAQ Page JSON-LD注入到页面头部。

方法二：手动添加代码(开发者适用)

如果你不想使用额外插件，或者需要实现高度定制化的Schema，可以将代码添加到主题的functions.php文件中。Google推荐使用wp_add_inline_script来注入JSON-LD，因为它能更好地避免缓存插件导致的问题。

代码示例：为文章页动态生成Article Schema

add_action('wp_enqueue_scripts', 'add_custom_json_ld_script');
function add_custom_json_ld_script() {
    // 仅在单篇文章页面执行
    if (is_single()) {
        // 获取必要的数据
        $title = get_the_title();
        $excerpt = get_the_excerpt();
        $author_name = get_the_author();
        $date_published = get_post_time('c', true);
        $date_modified = get_post_modified_time('c', true);
        $post_url = get_permalink();
        
        // 获取特色图片URL
        $image_url = '';
        if (has_post_thumbnail()) {
            $image = wp_get_attachment_image_src(get_post_thumbnail_id(), 'full');
            $image_url = $image[0];
        }

        // 构建JSON-LD数组
        $json_ld_data = array(
            '@context' => 'https://schema.org',
            '@type' => 'Article',
            'headline' => $title,
            'description' => wp_strip_all_tags($excerpt),
            'author' => array(
                '@type' => 'Person',
                'name' => $author_name,
            ),
            'datePublished' => $date_published,
            'dateModified' => $date_modified,
            'mainEntityOfPage' => array(
                '@id' => $post_url,
            ),
            'url' => $post_url,
        );

        // 如果有图片，则添加到数组中
        if (!empty($image_url)) {
            $json_ld_data['image'] = array(
                '@type' => 'ImageObject',
                'url' => $image_url,
            );
        }

        // 将数组编码为JSON字符串
        $json_ld = json_encode($json_ld_data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
        
        // 使用wp_add_inline_script注入
        wp_add_inline_script('wp-i18n', $json_ld, 'before');
    }
}

代码说明：

使用wp_add_inline_script(‘wp-i18n’,$json_ld,’before’)将JSON-LD注入到页面中，这个方法比直接add_action(‘wp_head’)更可靠。

所有数据都通过WordPress函数动态获取，确保与页面内容严格一致。

author使用嵌套对象格式，而不是纯字符串。

mainEntityOfPage通常直接使用当前页面的URL作为@id。

如果你需要在特定页面类型(如页面、首页)输出其他Schema类型，可以修改is_single()条件判断，并调整@type和相关属性。

方法三：使用SEO插件内置功能

如果你已经安装了Yoast SEO、Rank Math等主流SEO插件，它们本身就提供了强大的结构化数据功能。这些插件通常会自动输出基础的Organization、WebSite和Article Schema。

Rank Math：你可以在其设置中调整每个帖子/页面的Schema类型(如将页面设为WebPage而不是Article)，或通过rank_math/json_ld过滤器进行自定义修改。

Yoast SEO：同样支持多种Schema类型的自动生成和手动配置，通常能满足大多数标准需求。

如何选择?

你的需求	推荐方案
零代码，快速实现常见类型（如文章、本地商家）	使用 Schema Guru 或 Rank Math 等 SEO 插件内置功能。
需要在内容中灵活插入 FAQ、Recipe、Event	使用 Structured Content 或 AgilePress Schema JSON-LD Block 插件。
开发者，需要完全自定义所有 Schema 内容	采用 手动代码 方式，使用 wp_add_inline_script 添加。
需要批量管理 FAQ Schema 或控制 AI 爬虫	使用 DataStackLogic Schema Manager。

无论使用哪种方法，添加完成后，都建议使用Google富结果测试工具验证你的结构化数据是否有效。