TypeScript typeRoots未识别类型定义：嵌套结构ES6导入报错

在适配AWS Lambda层的项目中，依赖存放在dependencies/nodejs目录，根目录无法放置package.json。使用CommonJS语法导入uuid时编译正常，但改用ES6模块语法import { v4 as uuid } from 'uuid';时，出现类型声明找不到的错误：

Could not find a declaration file for module 'uuid'. 'C:/Users/project/dependencies/nodejs/node_modules/uuid/dist/index.js' implicitly has an 'any' type. Try 'npm i --save-dev @types/uuid' if it exists or add a new declaration (.d.ts) file containing 'declare module 'uuid';

已安装@types/uuid但问题依旧，配置typeRoots也未生效，以下是针对性的解决方法：

解决方案1：通过paths映射模块路径 #

修改tsconfig.json的compilerOptions部分，调整基础路径并添加模块映射，让TypeScript正确定位依赖包的类型文件：

{
  "compilerOptions": {
    "target": "es2017",                       
    "module": "commonjs",                     
    "outDir": "./dist",
    "strict": true,
    "noImplicitAny": true,
    "baseUrl": ".", // 设为项目根目录
    "typeRoots": ["./dependencies/nodejs/node_modules/@types"],
    "paths": {
      "*": ["dependencies/nodejs/node_modules/*"] // 所有模块都从指定依赖目录查找
    },
    "moduleResolution": "node", // 明确使用Node.js模块解析策略
    "esModuleInterop": true,
    "inlineSourceMap": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["**/*.spec.ts"]
}

配置后，TypeScript会自动从dependencies/nodejs/node_modules目录下查找所有导入模块的类型声明，包括uuid对应的@types/uuid。

解决方案2：添加本地类型声明文件（应急方案） #

如果上述配置仍未解决问题，可以手动添加类型声明文件：

1. 在项目根目录创建types文件夹，新建uuid.d.ts文件：

declare module 'uuid' {
  export function v4(): string;
  // 按需添加uuid其他方法的类型声明，如v3、v5等
}

2. 修改tsconfig.json的include字段，包含这个类型文件：

"include": ["src/**/*", "types/**/*"]

验证修复 #

执行编译命令验证配置是否生效：

npx tsc

此时ES6模块导入的类型错误应该会消失。

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