用途:帮助理解 TanStack Start 中代码运行位置,控制服务端与客户端的环境边界。核心原则:所有代码默认同构,服务端与客户端 bundle 都会执行,路由 loader 在 SSR 与客户端导航时均会运行,服务端操作必须使用 createServerFn。环境控制 API 包括:createServerFn() 用于 RPC 与数据变更(客户端发起网络请求,服务端直接执行);createServerOnlyFn() 客户端调用抛错;createClientOnlyFn() 服务端调用抛错;createIsomorphicFn() 按环境选用 .client() 或 .server() 实现;<ClientOnly> 与 useHydrated() 处理仅浏览器渲染。可用 import '@tanstack/<fw>-start/server-only' 或 client-only 将整个文件标记为单环境。环境变量:客户端仅暴露 VITE_ 前缀变量,服务端密钥不得加该前缀;process.env 必须在 .handler() 等按请求函数内读取,模块级读取既可能泄露又会在边缘运行时为 undefined。可用 src/env.d.ts 声明类型。限制:文件标记为实验性;同文件同时使用两种标记会报错。
start-core/execution-model
编程与开发
更新于 10-16 10:21