TypeScript新手使用io-ts遇报错：'Test'仅指类型却被当作值使用的问题排查与修复

嘿，这个坑我刚上手io-ts的时候也踩过！咱们直接说问题核心：

你写的interface Test是TypeScript编译时类型，编译之后这个东西就彻底消失了——它只在代码检查阶段有用，完全不存在于运行时环境里。但io-ts的t.type()方法需要的是运行时能访问到的编解码器对象，不是这种编译时才存在的类型标记，所以直接传Test就会抛出那个“类型被当作值使用”的错误。

修复方案（两种常用方式） #

方式一：从io-ts编解码器自动推导类型（推荐）

这种方式能避免重复定义，保证类型和运行时验证逻辑完全同步，是io-ts的标准用法：

import * as t from "io-ts";

// 先定义运行时的io-ts编解码器
export const testTypeV = t.type({
  test: t.string // 用io-ts提供的内置string编解码器
});

// 从编解码器自动生成TypeScript类型
export type Test = t.TypeOf<typeof testTypeV>;
// 此时Test的类型就是 { test: string }，和编解码器完全匹配

方式二：基于已有接口创建对应编解码器

如果已经提前定义了Test接口，你需要手动写一个和接口结构完全对应的io-ts编解码器（因为接口没法直接转成运行时对象）：

import * as t from "io-ts";

interface Test {
  s: string;
}

// 手动创建和Test接口匹配的编解码器
const testCodec = t.type({
  s: t.string
});

// 现在就可以把这个编解码器传给t.type()了
export const testTypeV = t.type({
  test: testCodec // 这里传的是运行时存在的编解码器对象，不是类型
});

// 同样可以推导外层类型
export type TestType = t.TypeOf<typeof testTypeV>;

额外提醒 #

io-ts的核心价值就是运行时数据验证，所以它所有的API都依赖运行时存在的编解码器对象，而TypeScript的接口/类型只是编译时的类型约束，两者不能直接混用。优先用第一种方式，能最大程度避免类型和验证逻辑不一致的问题。

内容的提问来源于stack exchange，提问作者St.Antario