必须先查出真实term_taxonomy_id再插入，不可硬编码；需用INSERT IGNORE避免重复键冲突，并手动更新wp_term_taxonomy.count字段确保统计准确。
wp_term_relationships 表直接插入前必须确认 term_taxonomy_id
直接往 wp_term_relationships 插数据，最常踩的坑是用了错误的 term_taxonomy_id 而不是 term_id。wordpress 不存标签名到这个表，只存「文章 id」和「分类法条目 id」的配对关系。而标签（tag）属于 post_tag 分类法，它的有效 term_taxonomy_id 得从 wp_term_taxonomy 表里查，条件是：taxonomy = 'post_tag' 且对应你要加的标签名。
实操建议：
- 先用
SELECT term_taxonomy_id FROM wp_term_taxonomy tt JOIN wp_terms t ON tt.term_id = t.term_id WHERE tt.taxonomy = 'post_tag' AND t.name = 'your-tag-name';拿到真实 ID - 别手动生成或硬编码
term_taxonomy_id—— 它可能因导入、合并标签而变动，term_id才是原始标识，但关系表只认前者 - 如果标签还不存在，得先插
wp_terms和wp_term_taxonomy两条记录，再用返回的term_taxonomy_id
批量插入要绕过 WordPress PHP 层，但得避开重复键冲突
用 wp_insert_post() 或 wp_set_post_tags() 批量处理几百上千篇文章，慢且容易超时；直连数据库快，但 wp_term_relationships 有联合主键 (object_id, term_taxonomy_id)，重复插入会报 Duplicate entry 错误，不是忽略就完事。
实操建议：
- 用
INSERT IGNORE INTO wp_term_relationships，跳过已存在的配对 - 或者用
INSERT ... ON DUPLICATE KEY UPDATE object_id = object_id（空更新，兼容性更好） - 别用
REPLACE INTO—— 它会先删后插，触发外键级联或影响计数器（比如count字段在wp_term_taxonomy中） - 一次插入别超过 5000 行，MySQL 默认
max_allowed_packet可能截断大语句
SQL 批量插入语句怎么写才安全高效
核心是：一次性生成所有 (object_id, term_taxonomy_id, term_order) 元组，避免循环拼 SQL。WordPress 的 term_order 对标签没意义，固定填 0 即可。
实操建议：
- 先查出所有要打标签的文章 ID：
SELECT ID FROM wp_posts WHERE post_status = 'publish' AND post_type = 'post'; - 把结果和确定的
term_taxonomy_id拼成 VALUES 列表，例如：INSERT IGNORE INTO wp_term_relationships (object_id, term_taxonomy_id, term_order) VALUES (123, 45, 0), (124, 45, 0), (125, 45, 0); - 如果文章量极大（>10 万），分批执行，每批 500–1000 行，用
LIMIT+OFFSET或按 ID 范围切片 - 执行前备份
wp_term_relationships表，哪怕只是CREATE TABLE wp_term_relationships_bak AS SELECT * FROM wp_term_relationships;
加完标签后必须手动更新 wp_term_taxonomy.count
WordPress 不会自动刷新标签计数，你插完关系行，wp_term_taxonomy.count 还是旧值，后台标签云、文章页显示数量、甚至某些主题的筛选逻辑都会错。
实操建议：
- 执行
UPDATE wp_term_taxonomy SET count = (SELECT COUNT(*) FROM wp_term_relationships tr WHERE tr.term_taxonomy_id = wp_term_taxonomy.term_taxonomy_id) WHERE taxonomy = 'post_tag' AND term_taxonomy_id = YOUR_TERM_TAXONOMY_ID; - 别用
wp_update_term_count_now()函数——它得走 PHP 加载全站环境，批量场景下反而更重 - 如果批量加了多个标签，就对每个涉及的
term_taxonomy_id单独跑一遍上面的UPDATE
这事容易被忽略，因为前台看起来“好像加成功了”，但统计类功能和缓存依赖的字段全不准，后续排查会绕远路。
