TypeScript引入cloudinary-react报ts(7016)找不到声明文件问题求助

你遇到的TS报错是因为旧版cloudinary-react官方未提供TS类型定义，且社区维护的@types/cloudinary-react包已下架/不存在，所以安装类型包会失败。

方案1：手动添加模块声明（适配现有用法，推荐） #

• 在项目src目录下新建custom.d.ts文件，写入以下内容：

declare module 'cloudinary-react' {
  import type { ComponentType } from 'react';
  // 按你实际用到的导出补全类型，也可以直接写any兜底
  export const Image: ComponentType<Record<string, any>>;
  export const Video: ComponentType<Record<string, any>>;
  export const Transformation: ComponentType<Record<string, any>>;
}

• 打开tsconfig.json，确保include数组包含该声明文件，示例配置：

{
  "compilerOptions": { /* 你的原有配置 */ },
  "include": ["src/**/*", "src/custom.d.ts"]
}

• 重启TS服务：VSCode按下Ctrl+Shift+P（Mac为Cmd+Shift+P），搜索并执行TypeScript: Restart TS Server即可生效。

此前设置"noImplicitAny": false无效，是因为TS未扫描到对应的声明文件，完成上述配置后即可解决。

方案2：替换为官方新版SDK（长期最优选择） #

旧版cloudinary-react已停止维护，官方当前主推的新版SDK自带完整TS类型定义，无需额外安装类型包：

• 卸载旧依赖：
  npm uninstall cloudinary-react
• 安装新版依赖：
  npm install @cloudinary/react @cloudinary/url-gen
• 替换原有导入即可，新版图片组件为AdvancedImage，功能完全覆盖旧版且支持更多扩展特性。

方案3：临时忽略类型检查（仅应急使用） #

如果只是临时测试不需要完整类型，可直接在导入语句上方添加忽略注释：

// @ts-ignore
import { Image } from 'cloudinary-react';

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