自定义scroll-to模块声明文件时出现找不到模块问题求助

DevOps 小满

2026-7-17

解决scroll-to自定义声明文件无法识别的问题

核心问题分析

TypeScript提示找不到模块声明，本质是没有扫描到你编写的scroll-to.d.ts文件，或是声明文件的配置存在细微偏差。

具体修复方案

方案1：调整声明文件位置到TS扫描范围内

你的tsconfig.json中include字段指定仅扫描src/types/**/*路径下的文件，因此必须把scroll-to.d.ts放到src/types目录下（例如src/types/scroll-to.d.ts），TypeScript就能自动识别该声明文件。

方案2：修改tsconfig的include配置覆盖声明文件路径

如果不想移动文件，直接修改tsconfig.json的include字段，把声明文件所在目录加入扫描范围：

{
  "include": [
    "src/types/**/*",
    "src/scroll-to.d.ts" // 假设你的声明文件在src根目录
  ]
}

或是直接用"src/**/*"覆盖src下所有文件，简化配置：

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

方案3：优化声明文件类型细节（可选）

当前声明文件写法正确，你可以补充ease参数的可选值类型，让类型提示更精准：

declare module "scroll-to" {
  type EaseType = 'in-quad' | 'out-quad' | 'in-out-quad' | 'in-cubic' | 'out-cubic' | 'in-out-cubic' | 'in-quart' | 'out-quart' | 'in-out-quart' | 'in-quint' | 'out-quint' | 'in-out-quint' | 'out-bounce';
  const scrollTo: (x: number, y: number, options?: {
      ease?: EaseType,
      duration?: number
  }) => void;

  export default scrollTo;
}