WordPress 代码实现自动为文章添加关键词标签

一、原理说明

• WordPress 标签本质是 post_tag 分类法（Taxonomy）
• 核心思路：通过文章标题 / 正文内容提取关键词，使用 wp_set_post_tags() 函数绑定标签
• 两种模式：新文章发布时自动添加标签、批量给旧文章生成标签
• 代码放在主题 functions.php 或自定义插件里，推荐子主题 functions.php，避免主题更新丢失代码

⚠️ 修改前：备份 functions.php，防止语法错误导致网站报错
 

二、方法 1：新文章发布时自动添加基础标签（以标题分词为例）

步骤 1：打开子主题 functions.php

外观 → 主题文件编辑器 → 选择子主题 functions.php

步骤 2：粘贴以下代码

// WordPress 自动为文章添加已使用过的标签
function array2object($array) { // 数组转对象
if (is_array($array)) {
$obj = new StdClass();
foreach ($array as $key => $val){
$obj->$key = $val;
}
}
else {
$obj = $array;
}
return $obj;
}
function object2array($object) { // 对象转数组
if (is_object($object)) {
foreach ($object as $key => $value) {
$array[$key] = $value;
}
}
else {
$array = $object;
}
return $array;
}
add_action('save_post', 'auto_add_tags');
function auto_add_tags(){
$tags = get_tags( array('hide_empty' => false) );
$post_id = get_the_ID();
$post_content = get_post($post_id)->post_content;
if ($tags) {
$i = 0;
$arrs = object2array($tags);shuffle($arrs);$tags = array2object($arrs);// 打乱顺序
foreach ( $tags as $tag ) {
// 如果文章内容出现了已使用过的标签，自动添加这些标签
if ( strpos($post_content, $tag->name) !== false){
if ($i == 5) { // 控制输出数量
break;
}
wp_set_post_tags( $post_id, $tag->name, true );
$i++;
}
}
}
}
/* 自动为文章内的标签添加内链 */
$match_num_from = 1; //一篇文章中同一个标签少于几次不自动链接
$match_num_to = 1; //一篇文章中同一个标签最多自动链接几次
function tag_sort($a, $b){
if ( $a->name == $b->name ) return 0;
return ( strlen($a->name) > strlen($b->name) ) ? -1 : 1;
}
function tag_link($content){
global $match_num_from,$match_num_to;
$posttags = get_the_tags();
if ($posttags) {
usort($posttags, "tag_sort");
foreach($posttags as $tag) {
$link = get_tag_link($tag->term_id);
$keyword = $tag->name;
$cleankeyword = stripslashes($keyword);
$url = "<a href=\"$link\" title=\"".str_replace('%s',addcslashes($cleankeyword, '$'),__('【查看更多[%s]标签的文章】'))."\"";
$url .= ' target="_blank"';
$url .= ">".addcslashes($cleankeyword, '$')."</a>";
$limit = rand($match_num_from,$match_num_to);
$content = preg_replace( '|(<a[^>]+>)(.*)('.$ex_word.')(.*)(</a[^>]*>)|U'.$case, '$1$2%&&&&&%$4$5', $content);
$content = preg_replace( '|(<img)(.*?)('.$ex_word.')(.*?)(>)|U'.$case, '$1$2%&&&&&%$4$5', $content);
$cleankeyword = preg_quote($cleankeyword,'\'');
$regEx = '\'(?!((<.*?)|(<a.*?)))('. $cleankeyword . ')(?!(([^<>]*?)>)|([^>]*?</a>))\'s' . $case;
$content = preg_replace($regEx,$url,$content,$limit);
$content = str_replace( '%&&&&&%', stripslashes($ex_word), $content);
}
}
return $content;
}
add_filter('the_content','tag_link',1);

<img fetchpriority="high" decoding="async" class="alignleft size-full wp-image-1626" src="https://www.aliz.cn/wp-content/uploads/2022/03/1646908737-a5022a0ab35a58a.png" width="1493" height="769" srcset="https://www.aliz.cn/wp-content/uploads/2022/03/1646908737-a5022a0ab35a58a.png 1493w, https://www.aliz.cn/wp-content/uploads/2022/03/1646908737-a5022a0ab35a58a-300x155.png 300w, https://www.aliz.cn/wp-content/uploads/2022/03/1646908737-a5022a0ab35a58a-1024x527.png 1024w, https://www.aliz.cn/wp-content/uploads/2022/03/1646908737-a5022a0ab35a58a-768x396.png 768w" sizes="(max-width: 1493px) 100vw, 1493px" title="wordpress代码实现自动为文章添加关键词标签插图1" alt="wordpress代码实现自动为文章添加关键词标签插图1" />

三、方法 2：读取文章自定义字段关键词，自动转为标签（适配 SEO 插件）

很多 SEO 插件（Yoast、Rank Math）会把关键词存入自定义字段，可直接读取转为标签

<pre class="language-php"><code> function auto_add_tags_from_seo_keywords($post_id) { if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id) || get_post_type($post_id) !== 'post') { return; } // 读取SEO关键词自定义字段（根据实际插件字段名修改） $seo_keywords = get_post_meta($post_id, 'rank_math_focus_keyword', true); if (!empty($seo_keywords)) { // 逗号分割关键词数组 $tag_array = array_map('trim', explode(',', $seo_keywords)); wp_set_post_tags($post_id, $tag_array, false); } } add_action('save_post', 'auto_add_tags_from_seo_keywords'); </code></pre>

四、方法 3：批量给旧文章自动添加标签（仅执行一次！）

把代码临时加到 functions.php，访问一次网站后立刻删除，避免反复执行

<pre class="language-php"><code> // 仅手动运行一次，批量给已发布文章添加标签 function batch_auto_add_tags() { // 查询所有已发布文章 $args = array( 'post_type' => 'post', 'post_status' => 'publish', 'posts_per_page' => -1, 'no_found_rows' => true, 'update_post_meta_cache' => false, 'update_post_term_cache' => false ); $query = new WP_Query($args); if ($query->have_posts()) { while ($query->have_posts()) { $query->the_post(); $pid = get_the_ID(); $title = get_the_title($pid); $words = explode(' ', trim($title)); $tags = array_slice($words, 0, 5); wp_set_post_tags($pid, $tags, false); } wp_reset_postdata(); } echo '批量标签添加完成，请删除此代码！'; exit; } // 访问首页执行一次：http://你的域名/?runbatchtag=1 if(isset($_GET['runbatchtag'])){ batch_auto_add_tags(); } </code></pre>

使用方法：

1. 粘贴代码保存
2. 浏览器访问：https://你的域名/?runbatchtag=1
3. 看到提示完成后，务必立刻删除这段批量代码，防止持续执行
4. 检查文章标签是否正常生成

五、进阶优化：中文文章关键词提取方案

1、简易方案：手动指定常用行业关键词数组

直接修改代码里的 $base_tags 数组，固定添加行业核心标签，兼顾 SEO 统一性。

2、专业方案：PHP 中文分词插件

引入 SCWS / Jieba PHP 分词库，对文章正文 get_the_content($post_id) 做精准中文分词提取高频关键词，提升标签精准度。 示例读取正文：

$post_content = get_post_field('post_content', $post_id);

六、常见问题排查

1. 标签没有自动生成
   • 确认代码正确放入子主题 functions.php，无 PHP 语法错误
   • 检查文章类型是否为 post（不是 page / 自定义类型）
   • 清除 WordPress 缓存、浏览器缓存
   • 查看 WP 后台文章编辑页标签模块确认标签是否添加成功
2. 标签重复 / 乱码
   • 使用 array_unique() 去重标签数组
   • 确保网站编码为 UTF-8
   • 关闭多余标签插件，避免冲突
3. 服务器报错白屏
   • 开启 WP 调试模式查看错误日志，修正 PHP 语法错误
   • 使用子主题，不要直接修改主主题 functions.php

七、总结

1. 核心函数：wp_set_post_tags() 用于绑定标签，save_post 钩子监听文章保存动作
2. 英文站点可直接用标题分词方案；中文站点优先 SEO 关键词字段读取 + 固定行业标签
3. 批量脚本仅运行一次，运行完成后务必删除，避免影响性能
4. 标签本质是辅助 SEO，不可完全依赖自动标签，重要文章可手动微调标签提升精准度

本文配套模板、静态源码可前往艾立兹素材库alisucai.com下载