Vue 适配
- 你需要在 Vue 中快速建立“可取消、可缓存、可失效刷新”的查询链路。
- 你希望把“快速上手 -> 读写实战 -> 生产上线”按固定结构交付给团队。
- 核心读取语义是 Ref（
.value），适合组合式 API。
API 能力矩阵
Section titled “API 能力矩阵”| 能力 | 主 API | 是否覆盖 |
|---|---|---|
| 标准查询 | useQuery | 是 |
| 无限查询 | useInfiniteQuery | 是 |
| 变更操作 | useMutation | 是 |
| Suspense 变体 | useSuspense* | 是 |
| SSR/CSR 一致性 | 可选 | 是 |
与其他框架差异
Section titled “与其他框架差异”- 核心读取语义是 Ref（
.value），适合组合式 API。 - 统一语义保持一致：
fetch / refetch / prefetch / invalidate / cancel。 - 差异主要在返回值消费方式（对象 / Ref / Accessor / Store）。
常见选型分叉
Section titled “常见选型分叉”1. 先做单资源还是直接做分页
Section titled “1. 先做单资源还是直接做分页”- 单资源/单页：先用标准查询建立 key 与取消语义。
- 列表滚动：直接进入无限查询，避免后续重构为分页模型。
2. 先做写操作还是先做只读
Section titled “2. 先做写操作还是先做只读”- 建议先完成只读 query，再接 mutation + invalidate。
- 写操作上线前必须验证失败回滚和重试策略。
3. 是否需要 SSR 首屏命中
Section titled “3. 是否需要 SSR 首屏命中”- 纯客户端可先不做 SSR，后续按路由场景补预取。