TypeScript中为外部库已声明类添加方法遇TS2693报错求解决

这个报错本质是因为你没搞对@pnp/sp里Site类的模块归属，以及类型扩展和运行时实现的配合问题，我给你一步步拆解决方法：

1. 修正类型扩展的模块路径 #

@pnp/sp的Site类其实是从@pnp/sp/sites子模块导出的，不是根模块@pnp/sp。你之前的类型定义写错了模块名，导致TypeScript无法把你扩展的接口和实际的Site类关联起来。

创建一个自定义类型文件（比如src/types/@pnp/sp/sites.d.ts），内容改成：

declare module '@pnp/sp/sites' {
  interface Site {
    getChanges: (query: any) => Promise<any>;
  }
}

2. 添加运行时方法实现 #

类型扩展只是告诉TypeScript这个方法存在，但实际运行时还得给Site类的原型加上方法逻辑。在你的项目里新建一个扩展文件（比如src/utils/pnp-extensions.ts），写如下代码：

import { Site } from '@pnp/sp/sites';

// 给Site原型添加getChanges方法的具体实现
Site.prototype.getChanges = async function(query: any): Promise<any> {
  // 这里替换成你调用SP REST API的逻辑，比如：
  const res = await this.fetch(`/_api/site/getchanges`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json;odata=verbose',
      'Accept': 'application/json;odata=verbose',
    },
    body: JSON.stringify({ query }),
  });
  return res.json();
};

记得在项目入口文件（比如main.ts或App.tsx）里导入这个扩展文件，确保运行时能加载到：

import './utils/pnp-extensions';

3. 让TypeScript识别自定义类型 #

检查你的tsconfig.json，确保自定义类型文件被包含进去：

{
  "compilerOptions": {
    // 其他配置...
    "typeRoots": ["./node_modules/@types", "./src/types"]
  },
  "include": [
    "src/**/*",
    "src/types/**/*"
  ]
}

这样操作后，TypeScript就能正确识别Site类的新方法，也不会再报那个"only refers to a type"的错误了。

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