is_main_query()

确定查询是否为主查询。
Determines whether the query is the main query.

目录锚点：#说明#返回#源码#笔记

说明（Description）

有关此主题函数和类似主题函数的更多信息，请参阅主题开发人员手册中的条件标记文章。

返回（Return）

（bool）

源码（Source）

/**
 * Is the query the main query?
 *
 * @since 3.3.0
 *
 * @global WP_Query $wp_query
 *
 * @return bool
 */
function is_main_query() {
	if ( 'pre_get_posts' === current_filter() ) {
		$message = sprintf( __( 'In %1$s, use the %2$s method, not the %3$s function. See %4$s.' ),
			'pre_get_posts', 'WP_Query::is_main_query()', 'is_main_query()', __( 'https://codex.wordpress.org/Function_Reference/is_main_query' ) );
		_doing_it_wrong( __FUNCTION__, $message, '3.7' );
	}

	global $wp_query;
	return $wp_query->is_main_query();
}

笔记（Notes）

使用WP_Query->is_main_Query（）而不是is_main_Query（）的示例（无效）