升级Node.js与TypeScript后部分文件编译失败（类型冲突）

});

## 编译错误信息
执行`pnpm run build`时抛出：

Argument of type 'GetAllSearchParams' is not assignable to parameter of type 'string | URLSearchParams | Record<string, string | readonly string[]> | Iterable<[string, string]> | readonly [string, string][] | undefined'

## 额外异常点
VSCode编辑器中显示的`URLSearchParams`构造参数类型与终端编译时不一致：
编辑器类型：

URLSearchParams | string | Record<string, string | ReadonlyArray> | Iterable<[string, string]> | ReadonlyArray<[string, string]>

## 相关类型定义
```typescript
export type GetAllSearchParams = NodeJS.Dict<string> & {
  limit?: number;
  next_string?: string;
};

1. 类型定义严格性变更：Node.js 18对应的@types/node版本中，URLSearchParams构造函数的参数类型被收紧，要求传入的对象值必须是string或readonly string[]类型；而旧版@types/node（对应Node.js 14）允许更宽松的类型（比如包含number值的对象）。你的GetAllSearchParams中limit是number类型，不符合新版本的类型要求。
2. 编辑器与编译环境类型不一致：VSCode可能缓存了旧的类型定义，或者使用了全局的@types/node版本，导致编辑器显示的类型与编译时项目依赖的类型不匹配。

方案1：转换参数类型（推荐） #

在传入URLSearchParams前，将所有参数值转为string类型，确保符合类型要求：

getAll: async (searchParams: GetAllSearchParams = {}): Promise<AllCustomer> => {
  // 将所有参数值转为string
  const formattedParams = Object.fromEntries(
    Object.entries(searchParams).map(([key, value]) => [key, String(value)])
  );
  const path = '/customers?' + new URLSearchParams(formattedParams);
  return await fetcher({path});
},

如果只想处理特定字段（比如limit），也可以针对性转换：

getAll: async (searchParams: GetAllSearchParams = {}): Promise<AllCustomer> => {
  const params = {
    ...searchParams,
    // 仅转换number类型的limit为string
    limit: searchParams.limit?.toString()
  };
  const path = '/customers?' + new URLSearchParams(params as Record<string, string>);
  return await fetcher({path});
},

方案2：调整类型定义 #

修改GetAllSearchParams，让limit兼容string类型，后续使用时确保传入的是string或者转换为string：

export type GetAllSearchParams = NodeJS.Dict<string> & {
  limit?: string | number;
  next_string?: string;
};

方案3：统一编辑器与编译环境的类型依赖 #

1. 打开VSCode设置，搜索typescript.tsdk，将其设置为项目本地的TypeScript路径（比如./node_modules/typescript/lib）。
2. 重启VSCode，确保编辑器使用的是项目依赖的@types/node版本，消除类型显示不一致的问题。

方案4：检查依赖一致性 #

执行pnpm list @types/node，查看是否有多个版本的@types/node被安装。如果存在版本冲突，执行以下命令清理并重新安装依赖：

pnpm store prune
pnpm install

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