---
title: "wordpress的重置函数"
url: "https://yjyj.net/learn/wordpress-learn/5514.html"
author: "小 虾 (生猛大蝦编辑部)"
published_at: "2016-07-27T21:04:39+08:00"
updated_at: "2016-07-27T21:23:23+08:00"
categories: "WordPress 学习"
tags: "wordpress, WordPress优化, WordPress开发, 重置函数"
summary: "本文专讲 WordPress 循环里最容易搞混的三个重置函数：wp_reset_postdata()、wp_reset_query() 和 rewind_posts()。它们分别对应 WP_Query、多重循环与 query_posts() 场景，帮你避免全局 $post 乱掉、查询结果串台。看完就能按场景选对函数，少"
source: "生猛大蝦 (https://yjyj.net)"
---

# wordpress的重置函数

> 来源：[生猛大蝦 (yjyj.net)](https://yjyj.net/learn/wordpress-learn/5514.html) · 作者：小 虾 · 发布时间：2016-07-27

## 30 秒核心看点 (TL;DR)

- wp_reset_postdata() 主要用于 WP_Query 多循环，恢复全局 $post。
- wp_reset_query() 适合 query_posts() 场景，会连同之前查询一起重置。
- rewind_posts() 用在同一页面重复使用查询结果时，方便把循环指针拨回开头。

做站写循环的时候遇到了乌龙，记录一下

```
wp_reset_postdata() 是重置 query_post
wp_reset_query() 是重置 WP_Query
```


wordpress官方wiki：

http://codex.wordpress.org/Function_Reference/wp_reset_postdata

http://codex.wordpress.org/Function_Reference/wp_reset_query

http://codex.wordpress.org/Function_Reference/query_posts

http://codex.wordpress.org/Class_Reference/WP_Query

 

### 重置WordPress循环的方法


总结一下，有三种方法，分别用于不同的情况，列表如下。



wp_reset_postdata()
wp_reset_query()
rewind_posts()



使用WP_Query创建多个循环是使用，不接受任何参数，恢复$post全局变量的数据
使用query_posts()自定义循环时使用，不接受任何参数，不仅恢复$post全局变量，还会销毁之前的查询
需要重用同一个页面的查询结果时使用

## 生猛大蝦编辑部 · 背景与实操延伸

这篇文章虽然短，但点中了 WordPress 循环里最常见的坑：查询对象和全局 $post 容易被覆盖。实战里如果你在模板中嵌套多个循环，先确认自己用的是 WP_Query 还是 query_posts()，再决定调用哪个重置函数。别把 rewind_posts() 当成万能重置，它只是把结果指针拨回起点，不会清理整个查询上下文。

## 延伸问答与排错指南 (FAQ)

### wp_reset_postdata() 和 wp_reset_query() 有什么区别？
wp_reset_postdata() 只负责恢复全局 $post 数据，常用于 WP_Query 创建的多个循环；wp_reset_query() 则用于 query_posts() 自定义循环，不仅恢复 $post，还会销毁之前的查询状态。两者不要混用，先看你是怎么发起循环的。

### 什么时候该用 rewind_posts()？
当你需要在同一页面里重复使用同一组查询结果时，用 rewind_posts() 把循环指针回到开头即可。它不是重置整个查询，而是让你能再次遍历已有结果，适合重复输出列表或二次渲染。

### 做 WordPress 循环时最容易出什么问题？
最常见的是循环结束后全局 $post 被改写，导致后续模板标签输出错乱，或者多个查询结果互相干扰。实操上要根据场景选择对应重置函数，尤其是使用 WP_Query 或 query_posts() 后，记得及时恢复上下文。

---
更多 Linux 运维、WordPress 性能优化、前端工程化、Shopify 独立站与极客折腾指南：[生猛大蝦全站文章归档 (https://yjyj.net/archive)](https://yjyj.net/archive)
