最近在对组里三个新人提交的 TypeScript 代码进行审查时我发现一样的问题反复出现。其实，你是否也在 Code Review 时碰到过这类“能跑但让人想打人”的写法？下面列出八个最常见的反模式，并给出简洁的修复方案。

反模式1这方面。any 当万能胶

痛点：在面对类型报错时直接使用 any 看似能快速处理问题，却让后续维护成本暴涨。

// ❌ 遇到类型报错就any
const handleResponse = => {
return data.result.items.map => item.name);}，

当 data 的结构发生变化时TypeScript 无法帮你发现错误，因为你告诉它 “我不在乎类型”。

// ✅ 花30秒定义类型
interface ApiResponse {
再看result。{
从items来看，Array<{ name: string; id: number }>;}，}
const handleResponse = => {
return data.result.items.map => item.name);}，

原则：每多一个 any你的 TypeScript 就退化成了带类型注释的 JavaScript。若确实不知道具体类型，请使用 unknown。不过，

反模式2的观点是。try-catch 里用 any 而不是 unknown

痛点：错误处理不规范会导致隐藏运行时异常，让调试变得更难。

// ❌ catch里用any
try { await fetchData;}
catch {
console.log;// 如果 error 不是 Error 对象呢？
console.log，// 如果没有 response 呢？}

Error,字符串。null 或

// ✅ 用 unknown + 类型守卫
try { await fetchData;}
catch {
if { console.log;}
if ) { console.log;}
}

反模式3的观点是，as 断言代替类型守卫

痛点：Eagerly using “as” can mask runtime bugs and makes code fragile.

// ❌ 到处用 as 强转
const user = response.data as User;话说回来，const element = document.getElementById as HTMLDivElement;const config = JSON.parse as AppConfig;

If underlying values don't match asserted type,you’ll get a runtime crash that TypeScript can’t catch.

// ✅ 用类型守卫做运行时检查
function isUser: data is User {
return (
typeof data === 'object' &&
data!== null &&
'id' in data &&
'name' in data
);}
const data = response.data;if ) {
// 在此处编译器和运行时都安全
console.log;}
// DOM 元素用 instanceof
const element = document.getElementById;if { element.style.display = 'flex';}
`
}，

🚀 常见错误快速定位

🔍 自评一下

• 问自己我在最近一次 Code Review 中至少打回了哪些写法？
• 对于上述任何一种写法，你有没有尝试过改进？
• 在项目中是否已有统一的编码规范来避免这些问题？

如果你在日常工作中遇到类似痛点，欢迎在评论区分享经验。按理说，祝你编码愉快，也愿你的团队保持高质量、可维护的 TypeScript 基础！