flutter_query

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Flutter Query 是一个状态管理包，用于获取、缓存和同步服务器数据，并自动处理加载、错误和成功状态。受 TanStack Query 启发，它通过提供声明式 API、后台更新和内置缓存失效功能，简化了 Flutter 应用中的数据获取。该包支持所有主要平台，并可无缝集成到 Flutter 的响应式生态系统中。通过智能缓存策略和自动重新获取，该包减少了样板代码并提升了性能。

适合场景

实时数据同步
离线优先的应用开发
API 数据缓存
使用服务器数据的动态 UI
自动后台刷新

主要特点

自动状态管理
内置缓存和过期后仍可验证
后台数据同步
声明式 API 设计
错误边界集成
在窗口获得焦点时重新获取数据

适合对象

开发数据密集型 Flutter 应用的开发者
寻求减少样板代码的团队
需要离线支持的应用程序
使用 REST 或 GraphQL API 的项目
需要实时数据更新的应用程序

使用建议

新用户的上手曲线
大型缓存可能导致的内存使用
需要理解响应式编程
在某些边缘情况下自定义功能有限
可能需要为复杂的认证流程进行额外设置

以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。

Flutter Query

A Flutter package inspired by TanStack Query for powerful asynchronous state management. Built with Flutter Hooks.

Coming from TanStack Query? Check out the differences to get started quickly.

Why Flutter Query?

Working with server data is hard. You need caching, deduplication, background refetching, stale data handling, and more. Flutter Query handles all of this out of the box:

Automatic caching with intelligent invalidation
Request deduplication so multiple widgets share a single network request
Background updates to keep data fresh
Stale-while-revalidate patterns for instant UI with fresh data
Optimistic updates for responsive mutations
Retry logic with exponential backoff

Documentation

Visit flutterquery.com for the full documentation, tutorials, and guides.

Platform Support

Android	iOS	macOS	Web	Linux	Windows
✅	✅	✅	✅	✅	✅

Requirements

Flutter >=3.32.0
Dart >=3.0.0 <4.0.0

Versioning

This project strictly follows Semantic Versioning. Given a version number MAJOR.MINOR.PATCH:

MAJOR version increments indicate breaking changes
MINOR version increments add functionality in a backward-compatible manner
PATCH version increments include backward-compatible bug fixes

Before version 1.0.0, MINOR version increments may include breaking changes.

Support

If you find Flutter Query useful, consider giving it a ⭐ to help others discover it!

搜索插件、代码仓与 APP 分类

安装插件