如何为Zod的parse方法实现静态类型检查与自动补全？

Zod的parse方法参数设为unknown是为了支持运行时校验任意输入，但如果想在开发阶段获得静态类型检查和自动补全，可以用以下几种方式：

方法1：给输入变量标注类型后再传入parse #

先声明输入变量并指定其类型为z.infer<typeof Book>，TypeScript会先做静态检查，确保输入结构符合要求，之后再通过parse做运行时校验：

import { z } from "zod"

export const Book = z.object({
  type: z.literal("book"),
  title: z.string(),
  published: z.number().int().min(1900)
});

// 标注输入类型，获得静态检查与自动补全
const input: z.infer<typeof Book> = {
  type: "book",
  title: "1984",
  published: 1949
};

const result = Book.parse(input);

方法2：自定义包装函数约束参数类型 #

写一个简单的包装函数，让它接收z.infer<typeof Book>类型的参数，内部调用Book.parse。这样调用包装函数时就能直接获得静态提示，同时保留运行时校验能力：

import { z } from "zod"

export const Book = z.object({
  type: z.literal("book"),
  title: z.string(),
  published: z.number().int().min(1900)
});

function parseBook(input: z.infer<typeof Book>) {
  return Book.parse(input);
}

// 调用时自动补全+静态检查
const result = parseBook({
  type: "book",
  title: "动物农场",
  published: 1945
});

注意事项 #

静态类型检查只能在开发阶段确保代码层面的输入合规，但如果输入来自外部（比如API响应、用户输入），静态检查无法覆盖这类场景，所以parse的运行时校验依然不可缺少，它能在运行时拦截不符合结构的输入。

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