使用tsc --declaration生成.d.ts缺失模块声明致tslint报错问题

我遇到过类似的情况——当用tsc --declaration或在tsconfig.json中设置declaration: true生成类型定义时，ES模块代码生成的.d.ts不会自动带上declare module "mymodule"结构。VSCode能正常识别导出的类型，但TSLint会因为无法正确解析模块类型，把导入的内容判定为any，触发"Unsafe use of expression of type 'any'"错误。下面是几个靠谱的解决办法：

1. 先检查tsconfig.json的模块配置是否正确 #

TypeScript生成的.d.ts结构和你的模块配置直接相关，确保这些字段设置正确：

• module：根据你的项目环境选择合适的模块格式，比如"CommonJS"（Node.js环境）或"ESNext"（现代前端）
• moduleResolution：要和module字段匹配，比如module设为CommonJS时，moduleResolution用"Node"；如果是ESNext，可以用"NodeNext"
• declaration：确保设为true，可以搭配declarationDir指定类型文件的输出目录，方便管理

示例配置片段：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "moduleResolution": "Node",
    "declaration": true,
    "declarationDir": "./types",
    "outDir": "./dist",
    "strict": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

2. 手动给生成的.d.ts添加模块包裹（必要时） #

如果自动生成的.d.ts还是没有模块结构，可以手动修改文件，把所有导出内容包裹在declare module中，模块名要和你项目package.json里的name字段一致：

比如你的test.ts生成的.d.ts原本是：

type PromiseResolve<T> = (value?: T | PromiseLike<T> | undefined) => void;
export async function delay(timeout: number): Promise<boolean>;

修改为：

declare module "mymodule" {
  type PromiseResolve<T> = (value?: T | PromiseLike<T> | undefined) => void;
  export async function delay(timeout: number): Promise<boolean>;
}

这样TSLint就能正确识别这是一个模块的类型定义，不会再误报any类型。

3. 调整TSLint规则避免误报 #

如果是TSLint的规则过于严格导致的误报，可以在tslint.json中针对no-unsafe-any规则添加例外：

{
  "rules": {
    "no-unsafe-any": [
      true,
      {
        "allow-type-assertion": true,
        "ignore-rest-args": true
      }
    ]
  }
}

不过更推荐优先解决模块配置的问题，而不是直接调整规则——毕竟no-unsafe-any规则是为了帮你避免类型不安全的代码。

小提示：确保导入方式正确 #

在其他文件中导入这个模块时，一定要用标准的ES模块或CommonJS导入语法，比如：

// ES模块
import { delay } from "mymodule";

// CommonJS
const { delay } = require("mymodule");

非标准的导入方式也可能导致TSLint无法正确识别类型。

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