最直接有效的做法是优先安装社区维护的 @types 包，如 npm install --save-dev @types/lodash；若无则创建 .d.ts 文件用 declare module 声明；慎用 @ts-ignore 或 any 临时绕过；最后可向 DefinitelyTyped 贡献类型定义。
当使用 TypeScript 引入没有内置类型定义的第三方库（比如某个纯 JavaScript 的 npm 包）时，TypeScript 会报错：“Cannot find module 'xxx' or its corresponding type declarations”。解决方法是为其手动补充声明文件（.d.ts），让 TypeScript 知道这个库的结构和导出内容。
确认是否已有类型定义
在动手写之前，先检查社区是否已有维护好的类型：
- 访问 DefinitelyTyped（如
@types/lodash）搜索对应包名； - 运行
npm install -D @types/xxx尝试安装（注意包名要匹配，有些需加@types/前缀，有些则内建在包里）； - 查看该库的
package.json是否有"types"或"typings"字段，说明它自带类型。
创建本地声明文件（最常用方式）
若无现成类型，可在项目中新建一个 types/xxx/index.d.ts 文件（路径可自定，但需确保被 TypeScript 加载）：
- 在
tsconfig.json的"typeRoots"或"files"/"include"中包含该目录； - 文件开头加
declare module 'xxx'，内部用export或export default描述导出； - 例如为一个只导出默认函数的库
my-logger写声明：
declare module 'my-logger' {
interface Logger {
log(message: string): void;
error(message: string): void;
}
const logger: Logger;
export default logger;
}
处理不同导出形式（CommonJS / ES Module / UMD）
根据库实际导出方式调整声明语法：
立即学习“Java免费学习笔记（深入）”；
-
CommonJS（
module.exports = xxx）：用export =+declare namespace或直接export =函数/类； -
ESM 默认导出（
export default xxx）：用export default（如上例）； -
命名导出（
export const a = ...）：用export const a: type;； -
全局变量（如挂载到
window.xxx）：用declare const xxx: ...，并确保该文件是全局声明（不带export或import）。
快速生成基础声明（辅助手段）
对简单库，可借助工具初步生成骨架：
- 用
npx dts-gen -m xxx（需全局安装dts-gen），它会尝试读取 JS 源码生成基础.d.ts； - 在 VS Code 中右键 JS 文件 → “Go to Definition”，跳转后按住 Ctrl/Cmd 点“Peek Definition”，有时能看见 JSDoc 推断出的类型，可参考补全；
- 临时在 TS 文件中用
require('xxx') as any或const xxx: any = require('xxx')绕过检查，再逐步替换为具体类型。
