如何保留/opt路径并解决TypeScript模块导入TS2307错误？

方法1：配置TypeScript路径映射（推荐） #

在项目的tsconfig.json中，通过baseUrl和paths让TypeScript编译时能解析/opt/开头的路径，同时保留运行时的绝对路径逻辑：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "/opt/dependencies/*": ["../dependencies/*"]
    }
  }
}

配置后，TypeScript会把/opt/dependencies/foo映射到本地相对路径../dependencies/foo来查找模块和类型声明，而运行时Node会直接使用/opt/绝对路径加载AWS依赖层的模块。

方法2：添加自定义类型声明文件 #

如果目标模块没有自带TypeScript类型，或者路径映射后仍存在类型报错，可以手动创建类型声明：

1. 在项目根目录创建typings/opt/dependencies目录
2. 新建foo.d.ts文件，根据模块实际导出内容声明类型：

declare module '/opt/dependencies/foo' {
  // 示例声明，需替换为模块真实导出结构
  export default function foo(): void;
}

3. 在tsconfig.json的include字段中加入类型目录：

{
  "include": ["src/**/*", "typings/**/*"]
}

方法3：调整模块解析策略 #

如果前两种方法无效，可以尝试让TypeScript对齐Node.js的模块解析规则，在tsconfig.json中添加：

{
  "compilerOptions": {
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true
  }
}

该配置能确保TypeScript正确识别CommonJS模块的默认导入逻辑，避免import语句的兼容性警告。

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