为什么package.json已装@types依赖仍需在tsconfig.json的types数组中声明

问题原因 #

这是TypeScript的types配置项的固有行为导致的：

• 默认情况下，如果你没有在tsconfig.json中显式配置types字段，TypeScript会自动扫描node_modules/@types下所有已安装的类型包，将对应类型定义注入到全局编译上下文，此时你安装了@types/gapi.client.gmail就不需要额外配置即可识别类型。
• 但你的项目已经显式声明了types数组，这会直接关闭TypeScript的自动类型引入逻辑，只有你明确写到types数组中的类型包，才会被加载到全局编译上下文。你之前没有把gapi.client.gmail加入数组时，哪怕已经在package.json中安装了对应的类型依赖，TypeScript也不会主动加载该包的类型定义，因此会抛出TS2339: Property 'gmail' does not exist on type 'typeof client'.错误。

可选优化方案 #

如果你不想每次新增@types依赖都手动修改tsconfig.json，可以删除types配置恢复自动加载逻辑；如果当初配置types是为了避免无关类型污染全局作用域（比如部分类型只需要在特定文件生效），保持现有写法，新增全局使用的类型包时同步更新types数组即可。

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