停止在 TS 中滥用.d.ts 文件：更高效的方式

在TypeScript项目中，开发者常常将.d.ts文件视为解决类型问题的”万能钥匙”。这种过度依赖导致项目中充斥着重复的类型声明、混乱的模块引用，甚至出现“声明文件地狱”。实际上，TypeScript提供了更优雅的类型管理方案，通过合理利用语言特性，我们可以减少80%不必要的.d.ts文件，同时提升代码可维护性和开发效率。

许多开发者误认为所有类型都需要显式声明，实际上TypeScript的类型推断系统可以自动推导出变量类型。例如：

const user = { name: 'John', age: 30 }; // 自动推断为{ name: string; age: number }

参考提供的目录结构示例，合理的项目应该：

src/
├─ types/          集中管理全局类型
├─ modules/        模块化业务代码
└─ shared/         公共工具类型

避免在每个模块都创建.d.ts文件，导致类型分散。

减少显式类型声明，充分利用TS的智能推导：

// 错误示范
interface User {
  name: string;
  age: number;
}
const getUser = (): User => { ... }

// 优化方案
const getUser = () => ({
  name: 'John',
  age: 30  // 自动推断返回值类型
})

创建全局类型声明文件夹：

// types/index.d.ts
declare global {
  type APIResponse = {
    data: T;
    status: number;
  }
}

在tsconfig.json中启用严格模式，从根源减少any滥用：

{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true
  }
}

利用Utility Types替代重复声明：

type UserPreview = Pick;
type OptionalUser = Partial;

通过@types规范安装类型定义：

npm install --save-dev @types/lodash @types/express

使用TS编译器分析类型使用情况：

npx tsc --noEmit --listFiles

创建核心类型定义层：

src/
└─ types/
   ├─ api.d.ts     API响应类型
   ├─ utils.d.ts   工具类型
   └─ global.d.ts  全局扩展

配置ESLint规则强制类型安全：

// .eslintrc
{
  "rules": {
    "@typescript-eslint/no-explicit-any": "error",
    "@typescript-eslint/typedef": ["error", {
      "arrowParameter": true
    }]
  }
}