WordPress中get_current_screen与global $pagenow的区别及用法

基础用法 #

全局变量 $pagenow #

$pagenow 是WordPress预置的全局字符串变量，仅在管理后台生效，存储当前后台页面对应的PHP文件名，前端访问时值为空。
使用示例：

// 调用前需先声明全局
global $pagenow;

// 判断当前是否在文章编辑页
if ( $pagenow === 'post.php' ) {
    // 对应业务逻辑
}

常见取值参考：

• index.php：后台仪表盘
• edit.php：文章/自定义文章类型列表页
• post-new.php：新建文章/自定义文章类型页
• upload.php：媒体库页
• edit-tags.php：分类/标签编辑页
  适用场景：仅需要做简单的后台页面类型判断，不需要额外页面信息的场景，调用成本极低。

函数 get_current_screen() #

WordPress 3.1及以上版本提供的内置函数，调用后返回WP_Screen类型的对象，包含当前后台页面的全量属性，同样仅在管理后台生效。

注意：该函数需要在current_screen钩子触发后调用才会返回有效对象，更早调用（如admin_init钩子执行阶段）会返回null。
使用示例：

$current_screen = get_current_screen();

// 先判断返回值是否有效，避免报错
if ( $current_screen && $current_screen->post_type === 'product' && $current_screen->base === 'edit' ) {
    // 当前在product自定义文章类型的列表页，执行对应业务逻辑
}

返回对象常用属性参考：

• base：页面基础类型，如post对应编辑页、edit对应列表页、upload对应媒体页
• post_type：当前页关联的文章类型别名
• id：当前后台页面的唯一标识
• is_block_editor：布尔值，标识当前页是否启用古腾堡块编辑器
  适用场景：需要精细化区分页面属性的场景，比如区分不同文章类型的编辑页、判断编辑器类型等。

二者核心差异 #

• 返回值类型不同：$pagenow是纯字符串，仅返回当前页的PHP文件名；get_current_screen()返回结构化对象，包含十余个页面相关属性，信息维度更丰富。
• 判断粒度不同：$pagenow仅能判断基础页面类型，所有文章类型的编辑页都会返回post.php，无法区分是默认文章、页面还是自定义文章类型；get_current_screen()可通过post_type属性精准区分关联的文章类型。
• 触发时机要求不同：$pagenow在后台页面加载早期就完成赋值，admin_init阶段即可正常调用；get_current_screen()需要等页面screen对象初始化完成后才会返回有效值，调用时机要求更严格。
• 兼容性范围不同：部分第三方开发的自定义后台页面如果没有按WordPress规范注册WP_Screen，get_current_screen()可能返回无效值，但$pagenow依然可以正常获取对应页面的文件名。

使用注意事项 #

• 二者均仅适用于WordPress后台场景，前端页面无法获取有效值，前端页面判断请使用is_page()、is_singular()等官方条件标签。
• 调用get_current_screen()前必须先判断返回值是否为有效对象，避免出现PHP致命错误。
• 仅做简单页面类型判断时优先使用$pagenow，性能开销更低；需要精细化判断时再使用get_current_screen()。

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