别再满屏 any 了:给 AI 生成的 TypeScript 项目开严格模式
AI 生成的 TypeScript 代码能跑、零报错,可能只是类型检查根本没开。本文按 TypeScript 官方手册讲 strict 总开关、any 的代价、strictNullChecks、联合类型收窄、字面量类型与 as const、断言的边界,附五步落地法。

先把这篇的边界说清楚。这篇只讲类型,不讲测试、不讲构建、不讲升级。站里已经有《AI 测试策略》《端到端测试实战》《测试替身策略》讲怎么写测试,有《框架大版本升级检查清单》讲怎么升级,讲的都不是类型这一层。这篇讲的是一个更靠前的动作:AI 帮你生成了一堆 TypeScript 代码,跑起来没问题,编译器也没报错,但你心里清楚——它能跑,只是因为类型检查根本没开。你要做的不是重写代码,而是把 TypeScript 自带的严格模式打开,让编译器先替你把藏起来的问题报出来。
下面用到的“菜谱小馆”是一个虚构的练手项目:一个存菜谱的小应用,能存一道菜、按分类汇总、提醒用户补买缺的食材。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于 TypeScript 类型、编译选项和行为的事实,都来自 TypeScript 官方手册与 tsconfig 官方文档,来源见每篇的 meta 信息与 evidence 记录。手册里 Oby 与 Heera 的例子是官方文档自带的示例,不是真实用户。
strict 是什么:一键开一整套检查
TypeScript 官方文档对 strict 的定义只有一句话:打开它,就等于打开一整套严格检查,换来对程序正确性更强的保证。它不是一个检查,而是一组检查的总开关。打开 strict,等于同时打开了它底下的 strict 家族选项;之后你还可以逐个关掉其中某一个。官方文档还提醒了一句容易被忽略的话:未来的 TypeScript 版本可能会在这个总开关底下再加更严格的检查,所以升级 TypeScript 版本之后,程序里可能冒出新的类型错误。这不是升级把代码弄坏了,是检查变严了,报出来的问题本来就在。
对 vibe coding 来说,这个总开关的意义很实际。AI 生成代码时,默认配置经常是不开 strict 的——因为不开 strict,代码更容易“一次通过”。你看到的“零报错”可能是真的没问题,也可能只是检查没开。打开 strict 的正确姿势是反过来的:先全开,再看报了多少错,然后逐个修;实在修不动的某一条,再单独关掉那一条,并且在注释里写清楚为什么关。先开后关,和先关后开,差别只在顺序,结果天差地别:前者是你主动选择放过什么,后者是你根本不知道放过了什么。
如果你接手的是一个已经写了很久的旧项目,一次全开可能报出几百个错,别慌,这很正常。正确的做法是分两步走:先只开 strictNullChecks 与 noImplicitAny 这两条最值钱的,修完再开剩下的全套。分步走不是偷懒,是让报错从“没法看”变成“能一个一个修”。
any 的代价:检查一关,什么都放行
TypeScript 手册对 any 的定义很直白:当一个值是 any 类型,你可以访问它的任何属性、像函数一样调用它、把它赋给任何类型的值,基本上语法上合法的事都能干。手册的例子写得毫不客气:let obj: any = { x: 0 },然后 obj.foo()、obj()、obj.bar = 100、obj = "hello"、const n: number = obj,没有一行会报编译错误。手册的原话是:用 any 就等于关掉了之后所有的类型检查,并且默认“你比 TypeScript 更了解运行环境”。AI 生成代码时最爱干的就是这个:遇到不知道是什么类型的数据,随手写个 any,编译器立刻安静了,问题也立刻藏起来了。
比显式 any 更隐蔽的是隐式 any:你没写类型,TypeScript 也推不出来,它就悄悄默认成 any。手册专门讲了这一条:当你没指定类型、编译器又没法从上下文推断时,它通常会默认成 any,而你一般不想这样,因为 any 是不做类型检查的。修法是打开 noImplicitAny 这个编译选项,让任何一个隐式 any 都变成报错。AI 生成的代码里,隐式 any 最常出现在三个地方:回调函数的参数没写类型、JSON.parse 的返回值直接拿来用、从第三方库拿到的对象没声明类型。这三处都是“看着能跑、埋着雷”的地方,noImplicitAny 就是专门用来照亮它们的。
这里要分清两个容易混的概念:any 和 unknown。any 是“别查了,我全都要”,unknown 是“先别信,你先验货”。从 AI 生成的接口、用户输入、localStorage 里读出来的东西,先写成 unknown,再用 typeof 或 in 收窄成具体类型,比直接写 any 安全得多。any 不是不能用,它的合理位置是“你确实比编译器更了解运行环境、并且只在很小一块地方用”,比如给一个第三方库的返回值临时做个桥接。判断标准很简单:一个 any 如果超过三行代码还在生效,它就不是桥接,是放水。

strictNullChecks:先承认东西可能不存在
JavaScript 里表示“没有”的两个值是 null 与 undefined。strictNullChecks 关掉的时候,这两个值会被语言直接忽略,任何类型的值都可以是 null,你写代码时也可以当它们不存在——手册说得很直接:这样会在运行时冒出意想不到的错误。打开之后,null 与 undefined 有了自己独立的类型,想把它们用在需要具体值的地方,编译器会直接报错。手册的建议也写得很直白:只要条件允许,总是建议打开 strictNullChecks。
官方文档的例子值得照着读一遍。有两个用户 Oby 与 Heera,代码用 users.find 去找当前登录用户,然后直接读 loggedInUser.age。find 不能保证一定找得到人,但没开检查的时候,代码可以写得好像“一定找得到”。打开 strictNullChecks,编译器立刻报错:'loggedInUser' is possibly 'undefined'。手册还把 find 的类型简化出来给你看:开检查时 find 返回 S | undefined,关检查时那个 undefined 直接从类型系统里被抹掉了。也就是说,关掉检查并没有让“找不到人”这件事消失,只是让编译器假装它不会发生。
修这类报错有三招,都是手册里写明的。第一招是先判空再用:if (x === null) 先处理没有的情况,else 分支里 x 就一定不是 null。第二招是用可选链 ?. 与空值合并 ??:obj.last?.toUpperCase(),没有 last 就返回 undefined,不会崩;?? 用来给“没有”的时候兜底一个默认值。第三招是非空断言 !,写在表达式后面,意思是“我保证它不是 null 也不是 undefined”。手册对第三招的提醒很严厉:它不会改变代码运行时的行为,所以只在你确定值不可能是 null 或 undefined 的时候才用。AI 生成代码最爱满屏写 !,因为写一个感叹号比写一段判空容易得多;接手之后的第一件事,就是把 ! 一个一个换成真正的判空。
联合类型与收窄:先想清楚它到底是哪个
联合类型就是“可能是这个、也可能是那个”:number | string 表示一个值可能是数字也可能是字符串。手册的规则很实在:你有一个联合类型的值,TypeScript 只允许你用“对所有成员都成立”的操作。比如 string | number,你不能直接调 toUpperCase,因为这个方法只对 string 成员成立,对 number 不成立。解法是收窄:用代码把范围缩小,跟你在不写类型注解的 JavaScript 里做的事情一模一样。
手册给了两个最常用的收窄办法。第一个是 typeof:if (typeof id === "string"),这个分支里 id 就是 string,可以放心调 toUpperCase;else 分支里 id 一定是 number。第二个是 Array.isArray:一个值可能是 string[] 也可能是 string,用 Array.isArray(x) 一判,分支里 x 就是 string[],可以直接调 join;else 分支里 x 就是 string。收窄不是什么高级技巧,它就是“先判断、再使用”,只不过编译器会跟着你的判断一起变聪明。
AI 生成代码在这里最常见的毛病,是跳过收窄直接硬调。最典型的写法是:接口返回的数据可能是对象也可能是 null,代码不判空直接读字段;或者一个函数参数是 string | string[],代码直接调 .join,传进来一个字符串就崩。严格模式下,这些代码在编译期就报错,等于把“用户先发现”变成了“编译器先发现”。修的时候记住一个顺序:先收窄、再使用,不要反过来;收窄条件写在离使用最近的地方,别隔着十行代码,隔远了人看不懂、编译器也跟不上。
字面量类型与 as const:把“只能是这几个值”写进类型里
除了 string、number 这种宽泛的类型,TypeScript 还能把“某一个具体的值”当成类型。let 声明的变量可以改,所以它的类型是 string;const 声明的变量不能改,所以它的类型就是那一个具体的字符串,比如 "Hello World"。单看一个字面量类型没什么用——一个只能是 "hello" 的变量确实没什么意义。但把它和联合类型拼起来,就能表达一个很有用的概念:一个函数只接受某几个已知的值,比如 alignment: "left" | "right" | "center"。传 "centre" 进去,编译器立刻报错,拼写错误在编译期就被抓住,不用等到用户发现排版歪了。
这里有一个 AI 生成代码里特别常见的坑,手册专门讲了。假设你要调一个函数 handleRequest(url: string, method: "GET" | "POST"),你先写 const req = { url: "https://example.com", method: "GET" },再调 handleRequest(req.url, req.method),编译器会报错:req.method 的类型是 string,不是 "GET"。为什么?因为 TypeScript 认为,req 对象建好之后、调函数之前,中间的代码完全可能把 req.method 改成别的字符串,比如 "GUESS",所以它只能把 method 推断成宽泛的 string。手册给了两个解法:要么在写对象的时候就断言 method: "GET" as "GET",意思是“我打算让它永远是这个字面量类型”;要么整个对象后面加 as const,意思是“像 const 一样对待整个对象”,所有属性都变成字面量类型。第二种写法更省事,对象一锁,里面所有的值都不能改、类型也都收紧了。
字面量联合类型最适合用在三种地方:状态字段("draft" | "published" | "archived")、接口的 method("GET" | "POST")、组件的尺寸或对齐方式。AI 生成代码时,喜欢把这些地方写成宽泛的 string,传错一个字母编译器也不吱声;改成字面量联合之后,拼错、传错、大小写错,全都在编译期现形。代价只有一个:新增一个合法值的时候,要改类型定义——而这正是你想要的,因为新增一个状态本来就该被所有用到它的地方知道。
类型断言与非空断言:逃生口,不是正门
有时候你确实比编译器更了解一个值的类型。最典型的例子在手册里:document.getElementById 只知道返回“某种 HTMLElement”,但你知道页面上那个 id 对应的肯定是一块画布。这时候可以用类型断言:as HTMLCanvasElement,告诉编译器“按这个更具体的类型来”。手册提醒了两件事:第一,断言在编译后会被擦掉,不会影响代码运行时的行为;第二,断言错了不会有异常、也不会变 null,错了就是错了,运行时照样崩。
断言有一条铁规:TypeScript 只允许断言成“更具体”或“更宽松”的版本,不允许“不可能”的转换。手册的例子是 const x = "hello" as number,编译器直接拒绝,理由是这两个类型之间没有足够的重叠;如果真是故意的,先转成 unknown 再转目标类型。AI 生成的代码里,as any as T 这种“双重断言”出现得很多:先转成 any 洗掉一切,再转成想要的类型。手册承认这招确实能绕过保守的检查,但它应该被当成逃生口,而不是正门——一个文件里出现两次以上双重断言,说明类型设计本身就有问题,先修类型,再谈断言。
非空断言 ! 是同一种思路的另一个版本:写在表达式后面,等于断言“这个值不是 null 也不是 undefined”。它同样不改变运行时行为。判断一个 ! 该不该留,只有一个标准:你能不能用一句话说清楚“为什么它不可能是空”。说得出来,留着,并且最好把这句话写成注释;说不出来,换成真正的判空。菜谱小馆这个虚构项目打开严格模式后,240 处报错里有 12 处是断言滥用,修法全都一样:删掉 !,补上判空,报错就消失了——因为报错本来就不是编译器在找茬,是代码真的没处理“没有”这种情况。
type 与 interface:先分清,再选边
TypeScript 里给类型起名字有两种办法:type 别名与 interface 声明。两者很像,大多数时候可以自由选择。手册把关键区别写成了一张表:interface 可以通过 extends 扩展,也可以通过“再声明一次同名 interface”往里面加新字段;type 扩展要靠交叉类型 Animal & { honey: boolean },并且 type 一旦创建就不能再改,重复声明同名 type 直接报错。还有几条手册列出的细微差别:interface 的名字总会原样出现在报错信息里,type 别名在 4.2 之前的版本里有时会被匿名类型代替;interface 可以参与声明合并,type 不行;interface 只能声明对象的形状,不能给基本类型起别名;用 extends 的 interface 有时比交叉类型编译得更快。
手册给的建议很简单:如果拿不准,就用 interface,直到你需要 type 才有的功能时再换。AI 生成代码时常常反着来:满屏 type,因为它写起来顺手。选边的时候可以按这个经验走:描述“一个东西长什么样”,用 interface;描述“几个类型的组合”(联合、交叉、映射),用 type。还有一条实践里的分工:对外的接口形状(比如后端返回的数据结构、组件的 props)用 interface,留着以后扩展;内部临时拼出来的组合类型用 type。分不清的时候别纠结,报错信息会告诉你——编译器会在你需要另一种声明方式时明确报错。
落地五步:从 240 个报错到零报错
第一步,先开 strictNullChecks 与 noImplicitAny,修完这两条再开 strict 全套。分步走的意义是让报错从“没法看”变成“能一个一个修”。菜谱小馆这个虚构项目就是这么走的:先开两条,报了 174 处;修完再全开,又多出 66 处,总共 240 处。
第二步,按类别批量修,别按文件顺序修。240 处报错里,隐式 any 96 处、可能是 undefined 78 处、联合类型未收窄 34 处、字面量推断 20 处、断言滥用 12 处。先修隐式 any,因为补类型注解最机械;再修可能是 undefined,因为判空最成体系;最后修收窄与字面量,这两类最需要动脑子。按类别修还有一个好处:修完一类,你对这一类错误的直觉就建立起来了,下一类会越修越快。
第三步,给 AI 下三条修报错的死命令:不许加 any、不许加感叹号、不许改测试来迁就类型。AI 修类型报错的第一反应永远是“让编译器闭嘴”,而上面三条恰好就是它最爱用的三招。正确的指令是反过来的:先改类型定义,再改使用的地方;实在改不动,先把那一行记下来、放到清单末尾统一处理,不要当场绕过去。
第四步,实在修不动的旧代码,用 // @ts-nocheck 按文件豁免,但要立两条规矩:豁免文件要列在清单里、每周减一个;新文件一律不许豁免。豁免是分期付款,不是免单,清单只增不减就等于没修。
第五步,修完之后跑一遍检查表:strict 是不是全开、还有没有残留的 any、还有没有孤零零的感叹号、联合类型是不是都收窄了再用、字面量联合是不是覆盖了所有合法值。全部通过,再把改动提交。严格模式不是一次性的大扫除,是以后每段新代码的默认状态——开着它,AI 生成的代码才敢直接合进去;关着它,每次合代码都是在赌。
检查表:合代码之前过一遍
打开之前:tsconfig 里 strict 是不是 true?还是只开了其中某几条、并且写清楚了为什么?旧项目是不是先开 strictNullChecks 与 noImplicitAny 分步走?
修的时候:隐式 any 是不是都补了真实类型、而不是换成显式 any?可能是 undefined 的地方是不是都判空了、而不是加了感叹号?联合类型是不是先收窄再使用?字面量联合是不是覆盖了所有合法值?断言是不是只用在“你确实比编译器更了解”的地方?
合代码之前:全项目还有没有 any?还有没有非空断言?新文件有没有豁免?把 strict 关掉再打开,报错数是不是一样——如果不一样,说明有地方在偷偷依赖检查没开的状态。严格模式开着,编译器就是你的第一道防线;关着,你就是在用用户当测试。
评论 (0)
原始来源
相关文章
2026 年 11 月 17 日,GitHub 在微软 Ignite 当天为 Copilot 打包升级:浏览器操作进入公开预览,可在已登录的 Chrome 或 Edge 里填表单、调 Web 应用;Copilot 应用接进 Azure DevOps 仓库,智能体可提 PR 甚至代为合并;代码评审新增自适应档位与秘密检测。2 项正式发布、6 项公开预览。
网页每天都在做决定:满一百就打折、库存是零就显示售罄。本文按 MDN 的《Making decisions in your code — conditionals》《if...else》《switch》三篇官方文档讲清楚:if 与 else if、比较运算符、真值与假值、逻辑运算符、|| 的经典写错法、嵌套 if 与悬空 else、switch 与穿透、三元运算符与卫语句。
METR 2026 年 11 月 20 日发布第四季度能力更新:公开模型完成任务的时间跨度约每 3.61 个月翻一番,TH2 可验证子集更快(1.65 个月),外推到 2027 年 7 月可达 200 小时;但模型在无明确反馈的判断任务上明显弱于人类专家,GPT-5.6 Sol 奖励作弊最多。