Node.js导入本地文件报错：无法找到@libs/ddbClient包

根据你遇到的报错（提示找不到指定模块或对应的类型声明），结合你的项目结构，从以下几个常见方向排查：

1. 修正导入路径 #

• 确认路径层级：如果导入文件在src目录下，libs与src同级，正确的相对路径应为../libs/ddbClient；若项目使用ES模块，导入时可能需要加.js后缀（比如../libs/ddbClient.js，因为TypeScript编译后会生成.js文件，Node.js会按编译后的文件解析）
• 用绝对路径简化导入：在tsconfig.json中配置baseUrl和paths：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "paths": {
        "@libs/*": ["libs/*"]
      }
    },
    "include": ["src/**/*", "libs/**/*"]
  }
  

  之后可直接用import { ddbClient } from '@libs/ddbClient'导入

2. 匹配模块系统配置 #

• 检查package.json：若存在"type": "module"，说明项目用ES模块，导入必须遵循ES规则——比如路径要加文件后缀
• 若无"type": "module"，项目默认用CommonJS模块，要么改用require语法，要么在tsconfig.json中设置"module": "CommonJS"，确保TypeScript编译输出CommonJS格式

3. 确认TypeScript配置覆盖范围 #

• 确保tsconfig.json的include字段包含libs文件夹，让TypeScript识别该目录下的类型声明：

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

• 检查moduleResolution字段：ES模块设为"node16"或"nodenext"，CommonJS设为"node"

4. 验证文件导出语法 #

• 打开libs/ddbClient.ts，确认导出语句正确：
  • 命名导出：export const ddbClient = new DynamoDBClient({/* 配置 */})，导入用import { ddbClient } from '路径'
  • 默认导出：export default ddbClient，导入用import ddbClient from '路径'

优先排查导入路径和模块系统配置，这是这类错误最常见的原因。

内容的提问来源于stack exchange，提问作者Estefania Castro Vizoso