Next.js集成私有UI库后构建报错：找不到react-datepicker声明文件求助

问题根源 #

你的私有UI组件库把@types/react-datepicker放在了devDependencies里，npm/yarn安装私有库时不会自动把开发依赖同步到主项目的node_modules，导致Next.js生产构建时找不到类型声明文件。

具体解决办法 #

办法一：主项目直接补装类型包 #

在你的Next.js项目根目录执行命令：

npm i --save-dev @types/react-datepicker
# 用yarn的话
yarn add -D @types/react-datepicker

这是最快的临时修复方式，直接解决当前项目的构建报错。

办法二：调整私有库的依赖配置（推荐长期方案） #

如果想让所有用这个私有库的项目都不用重复操作，改私有库的package.json：

1. 把@types/react-datepicker从devDependencies移到dependencies里
2. 重新发布私有库的新版本
3. 回到Next.js项目更新私有库：

npm update your-private-ui-library
# yarn用户执行
yarn upgrade your-private-ui-library

这样主项目安装私有库时会自动拉取所需的类型包，一劳永逸。

办法三：给私有库加自定义声明文件 #

不想动依赖结构的话，在私有库的源码目录或根目录新建typings/react-datepicker.d.ts文件，内容写：

declare module 'react-datepicker';

然后修改私有库的tsconfig.json，确保这个声明文件被识别：

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

重新发布私有库后，主项目就能识别这个自定义声明，不会再报类型缺失。

办法四：检查Next.js的TS配置 #

确认Next.js项目的tsconfig.json里typeRoots包含node_modules/@types，默认配置没问题，但如果改过配置可以检查：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types"]
  }
}

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