用途:面向使用 Convex 构建响应式应用的开发者,整理实时订阅、乐观更新、缓存与游标分页等实现模式。
主要能力:useQuery 自动创建订阅并实时更新;查询结果被缓存并在组件间共享;所有订阅看到一致的数据库视图;仅在相关数据变化时重新渲染。支持条件查询(用 "skip" 跳过)、useMutation 触发自动重渲染、withOptimisticUpdate 在服务端确认前先展示变更(出错自动回滚)、usePaginatedQuery 配合 paginationOptsValidator 实现游标分页与无限滚动,以及多个订阅独立更新。
使用方式:实现前先查阅官方文档,主要参考 https://docs.convex.dev/client/react、https://docs.convex.dev/client/react/optimistic-updates、https://docs.convex.dev/database/pagination,更广上下文见 https://docs.convex.dev/llms.txt。服务端用 query/mutation 定义接口,客户端从 ../convex/_generated/api 导入 api 调用。
适用场景:实时聊天、任务列表、仪表盘等需要数据即时同步的界面。
限制与注意:资料明确要求,除非被明确指示,否则不要运行 npx convex deploy,也不要运行任何 git 命令;条件查询应使用 "skip" 而非条件调用 Hook;需显式处理 undefined 加载状态;分页应选择合适页大小以避免过度获取。资料未提供收费、价格、平台支持范围等信息。