启用TypeScript的allowJs=true时node_modules中缺失./lib文件的问题

看起来你遇到了TypeScript编译后依赖路径错乱的坑，我之前在从JS转TS的项目里也碰到过类似情况，咱们一步步拆解问题并解决：

问题根源 #

你的错误提示里路径指向了dist/node_modules/request/index.js，这说明TypeScript编译器错误地把node_modules里的第三方依赖也编译/复制到了dist目录下，破坏了request模块原本的内部相对引用结构，导致它找不到./lib/cookies这种内部文件。

触发这个问题的关键配置组合：

• allowJs: true：允许TS处理JS文件，但如果你的JS文件引用了第三方依赖，编译器可能误把依赖文件也纳入输出
• paths里的"*": ["node_modules/**/*"]：这个配置画蛇添足，会让TS解析模块时优先指向node_modules，甚至触发依赖文件的编译输出
• 虽然你配置了include: ["./src/**/*"]，但如果src目录里不小心放了node_modules（比如误在src里装了依赖），也会被编译器处理

具体修复步骤 #

1. 给TS明确排除node_modules目录 #

在tsconfig.json里添加exclude配置，彻底禁止编译器处理依赖文件：

{
  "compilerOptions": {
    // 保留你原有的其他配置
    "module": "commonjs",
    "allowJs": true,
    "esModuleInterop": true,
    "target": "es6",
    "noImplicitAny": true,
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true,
    "sourceMap": true,
    "outDir": "dist",
    "baseUrl": ".",
    "paths": {
      // 这里后面会调整
      "*": [ "node_modules/**/*", "src/types/*" ]
    }
  },
  "include": [ "./src/**/*" ],
  // 新增排除配置
  "exclude": ["node_modules", "./src/node_modules"]
}

2. 修正paths配置，避免干扰依赖解析 #

你原来的paths配置里"*": ["node_modules/**/*"]完全多余——Node本身会自动从项目根目录的node_modules找依赖，改成只针对你的自定义类型即可：

"paths": {
  "@types/*": ["src/types/*"]
}

这样既保留了自定义类型的解析能力，又不会打乱第三方依赖的正常加载逻辑。

3. 检查依赖安装位置 #

确保你的node_modules在项目根目录，而不是src文件夹里。如果之前误在src里装了依赖，执行以下命令修复：

# 删除src里的错误node_modules
rm -rf src/node_modules
# 回到项目根目录重新安装依赖
npm install

4. 清理旧的dist目录，重新编译 #

之前的错误编译已经在dist里生成了错误的node_modules文件夹，先清理再重新编译：

rm -rf dist
tsc

额外优化建议 #

如果你想让TypeScript更好地支持requestRetry，可以安装它的类型定义文件：

npm install @types/request @types/request-promise --save-dev

完成以上步骤后，运行你的应用应该就能正常工作了——此时dist目录下只会有你自己的源码编译产物，第三方依赖会直接从项目根目录的node_modules加载，不会再出现路径错误。

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