如何解决TypeScript中Zod相互递归Schema的初始化错误？

你遇到的是典型的循环引用导致变量未初始化问题：SpatialEntity里引用了SpatialPlacement，但定义SpatialEntity时SpatialPlacement还没创建；反过来调整顺序的话，SpatialPlacement里的SpatialEntity又未初始化，所以无论怎么调顺序都会报错。

Zod提供了z.lazy()方法来解决这种循环依赖场景，它通过延迟解析引用的Schema，避免初始化时的访问冲突。修改后的代码如下：

import { z } from "zod";

// 先声明类型（可选，但能提升TypeScript的类型提示体验）
export type SpatialEntity = z.infer<typeof SpatialEntity>;
export type SpatialPlacement = z.infer<typeof SpatialPlacement>;

// 假设你已定义SpatialPlacementCommon，示例如下：
const SpatialPlacementCommon = z.object({
  // 这里填写SpatialPlacementCommon的实际字段，比如：
  position: z.string()
});

export const SpatialEntity = z.object({
  dimension_units: z.string().optional(),
  // 用z.lazy()延迟获取SpatialPlacement，避免初始化时的引用错误
  placement: z.lazy(() => SpatialPlacement)
});

export const SpatialPlacement = SpatialPlacementCommon.extend({
  source: z.string().or(SpatialEntity).optional(),
  target: z.string().or(SpatialEntity)
});

关键说明： #

• z.lazy(() => Schema)：接收一个返回目标Schema的函数，只有在实际校验数据时才会执行这个函数，此时所有Schema都已完成初始化，不会再出现"Cannot access before initialization"错误。
• 提前声明类型：用z.infer<typeof Schema>可以提前获取Schema对应的TypeScript类型，不影响初始化顺序，同时保留类型检查能力。

内容的提问来源于stack exchange，提问作者Himanshu Joshi