Next.js引入tailwind-scrollbar提示找不到模块声明文件如何解决

开发Next.js应用过程中引入Tailwind生态依赖包，在tailwind.config.js配置文件中通过require语句引入插件时，持续抛出类型缺失错误，错误信息如下：

Could not find a declaration file for module 'tailwind-scrollbar'. 
'/Users/beatsbyrsd/Documents/JavaScript/React/instagram-clone/node_modules/.pnpm/tailwind-scrollbar@1.3.1/node_modules/tailwind-scrollbar/src/index.js' 
implicitly has an 'any' type. 
Try `npm i --save-dev @types/tailwind-scrollbar` if it exists or add a 
new declaration (.d.ts) file containing `declare module 'tailwind-scrollbar';

使用的tailwind.config.js配置内容如下：

module.exports = {
    content: [
        "./pages/**/*.{js,ts,jsx,tsx}",
        "./components/**/*.{js,ts,jsx,tsx}",
    ],
    theme: {
        extend: {},
    },
    plugins: [
        require("@tailwindcss/forms"),
        require("tailwind-scrollbar"),
        require("tailwind-scrollbar-hide"),
    ],
};

• 创建global.d.ts文件声明对应模块
• 执行npm i --save-dev @types/tailwind-scrollbar安装类型依赖

按优先级从高到低尝试以下方案，可覆盖这类报错场景：

• 跳过配置文件的类型检查
  tailwind.config.js是Node环境运行的构建配置文件，不需要做严格的TypeScript类型校验，直接在文件最顶部添加// @ts-nocheck注释，告知TS跳过对该文件的检查即可，该操作不会影响业务代码的类型校验逻辑，也是Tailwind官方推荐的配置文件报错处理方式。修改后的配置文件结构如下：

  // @ts-nocheck
  module.exports = {
      content: [
          "./pages/**/*.{js,ts,jsx,tsx}",
          "./components/**/*.{js,ts,jsx,tsx}",
      ],
      theme: {
          extend: {},
      },
      plugins: [
              require("@tailwindcss/forms"),
              require("tailwind-scrollbar"),
              require("tailwind-scrollbar-hide"),
      ],
  };
  

• 修正类型声明文件的加载范围
  如果不想跳过整个配置文件的检查，先确认你写的.d.ts文件被TS配置纳入扫描范围。在项目根目录创建env.d.ts，写入以下声明内容：

  declare module 'tailwind-scrollbar';
  declare module 'tailwind-scrollbar-hide';
  

  打开根目录tsconfig.json，检查include字段是否覆盖了根目录下的d.ts文件，标准Next.js项目的include配置参考：

  {
    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", "*.d.ts"]
  }
  

  大部分场景下添加d.ts文件不生效，都是因为include配置只扫描了pages、components目录，没有把根目录的类型声明文件纳入编译范围。
• 清理缓存重装依赖
  如果使用pnpm作为包管理器，先删除node_modules目录和.next缓存文件夹，重新执行pnpm install安装全量依赖后重启开发服务，包管理器缓存或者Next构建缓存也可能导致类型识别异常。

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