get_category_link() 是获取 WordPress 分类静态地址最稳妥的方式,自动适配固定链接结构,传入有效整数 ID 即可;需校验分类存在性,避免硬编码路径,并注意上下文环境与重写规则刷新。

PHP中用 get_category_link() 获取栏目静态地址
WordPress 默认开启固定链接后,栏目页地址是类似 /category/news/ 这样的静态化路径。直接调用 get_category_link( $cat_id ) 是最稳妥的方式——它会自动适配当前固定链接结构,无论你是使用「朴素」、「年/月/日」还是「自定义结构」,都不需要手动拼接。
常见错误是硬写 /category/xxx 或用 home_url() . '/category/' . $slug,一旦后台改了固定链接规则(比如改成 /news/ 直接去掉 category 前缀),这类地址立刻 404。
-
$cat_id必须是整数,传字符串 ID(如'12')可能返回空或错误地址 - 如果传入不存在的 ID,函数返回首页 URL,不是 false 或 null,需用
get_term_by( 'id', $cat_id, 'category' )先校验 - 在循环外使用时,确保全局
$post未被干扰;若在WP_Query自定义查询后调用,建议加wp_reset_postdata()
获取当前栏目页的静态地址:用 get_queried_object() 判定上下文
在 category.php、archive.php 或自定义分类模板里,不能直接用 get_category_link() 而不指定 ID,否则容易取错。正确做法是先判断当前查询对象是否为分类:
$queried_obj = get_queried_object();
if ( $queried_obj && 'category' === $queried_obj->taxonomy ) {
$cat_link = get_category_link( $queried_obj->term_id );
}
注意:is_category() 只判断是否进入分类归档页,但不保证 $wp_query->get_queried_object() 一定存在或类型准确,尤其在多条件 query(如 ?cat=5&tag=tech)下,get_queried_object() 可能返回 tag 对象而非 category。
立即学习“PHP免费学习笔记(深入)”;
自定义固定链接结构下,get_category_link() 仍可靠吗?
可靠。该函数底层调用 get_term_link(),而后者会读取 rewrite 参数(来自 register_taxonomy() 或默认分类注册逻辑)和 permalink_structure 配置,动态生成匹配的 URL。即使你把分类前缀从 category 改成 topic,只要重写规则已刷新(保存过固定链接设置),get_category_link() 就会输出 /topic/xxx/。
唯一例外是启用了「朴素」(Plain)固定链接模式(即 ?cat=12 形式),此时函数仍返回带 query 的地址,不是静态路径——但这属于站点未启用静态化的本质问题,不是函数缺陷。
- 修改固定链接后务必点一次「保存更改」,否则 rewrite 规则未更新,前端 404,但
get_category_link()返回的仍是旧结构(缓存未刷新) - 插件如 Yoast SEO 或 Rank Math 可能覆盖默认 rewrite,此时应优先用它们提供的 API(如
YoastSEO()->helpers->redirect->get_redirect_url()),而非直接调用原生函数
静态地址生成失败?检查这三点
返回空、首页链接或明显错误路径,大概率不是函数问题,而是环境或参数异常:
- 传入的
$cat_id是 0、null 或未定义变量,函数默认返回首页 URL - 分类被设置为「不显示在导航中」或
public设为 false(通过register_taxonomy()自定义时),get_category_link()仍会生成地址,但该地址实际不可访问(返回 404) - 主题或插件用
pre_get_posts修改了主查询,导致get_queried_object()失效,此时应改用get_term_link( $term, 'category' )显式传入 term 对象
生成静态地址这件事本身不复杂,难的是在各种钩子、查询改造、缓存机制交织的环境中,确保你拿到的是「当前语义下真正有效的那个 URL」——而不是看起来像静态地址的字符串。











