Node.js项目更新包时出现@types/pg缺失的TS7016错误如何解决？

快速修复步骤 #

1. 安装官方类型声明包 #

针对pg模块，社区维护了对应的TypeScript类型声明包，直接安装为开发依赖即可：

使用npm：

npm install --save-dev @types/pg

使用pnpm（匹配错误信息中的包管理器）：

pnpm add -D @types/pg

2. 手动创建声明文件（备用方案） #

如果无法找到对应的@types包（此场景下极少出现），可以手动添加类型声明：

• 在项目中创建types目录（若不存在）
• 在该目录下新建pg.d.ts文件，写入以下内容：

declare module 'pg';

• 确保tsconfig.json的include配置包含这个声明文件目录：

{
  "include": ["src/**/*", "types/**/*"]
}

问题原因解析 #

更新包后出现这类错误通常是以下原因：

• 部分npm包未内置TypeScript类型声明，依赖独立的@types/xxx包提供类型支持
• 主包更新时，对应的@types包可能因版本不兼容、未被显式声明而被包管理器移除
• TypeScript配置变更（如skipLibCheck设为false），导致之前被忽略的类型检测错误被触发

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