安装@types/qs后TypeScript无法导入qs的问题求解

先澄清误解 #

@types/qs 是单独的类型定义包，不会覆盖node_modules/qs里的JS本体包，它的文件存放在node_modules/@types/qs目录下，作用是给TypeScript提供qs的类型提示，和qs本体包相互独立，必须同时安装两者才能正常使用。

具体解决方案 #

1. 确保同时安装qs本体和类型包

执行以下命令重新安装依赖，确保两者都被正确安装：

npm install qs @types/qs --save

2. 检查TypeScript配置

你的tsconfig.json使用了项目引用（references），需要检查子配置文件（比如tsconfig.app.json）中的compilerOptions，确保包含以下关键配置：

{
  "compilerOptions": {
    "moduleResolution": "node", // 启用Node.js模块解析逻辑
    "esModuleInterop": true,    // 支持CommonJS模块的默认导入
    "allowSyntheticDefaultImports": true // 配合esModuleInterop启用默认导入
  }
}

如果自定义了typeRoots，需要确保包含node_modules/@types目录，让TypeScript能找到类型定义：

"typeRoots": ["node_modules/@types"]

3. 调整导入方式

如果配置后默认导入仍报错，可以改用命名空间导入：

import * as qs from 'qs';
// 使用示例：qs.stringify({ foo: 'bar' })

4. 版本兼容性检查

确保qs和@types/qs的版本匹配（比如qs v6.x对应@types/qs v6.x），版本不匹配可能导致类型识别失败。可以指定版本安装：

npm install qs@6 @types/qs@6 --save

代码示例调整建议 #

将qs的导入改为命名空间导入，同时把其他require改为import，保持代码风格统一：

import FormData from 'form-data';
import axios from 'axios';
import * as qs from 'qs'; // 修改此处
import * as fs from 'fs';
import * as mime from 'mime-types';
import * as path from 'path';
import * as readChunk from 'read-chunk';

内容的提问来源于stack exchange，提问作者Nguyễn Thế Hưng