已安装dotenv并配置TypeScript仍提示找不到模块的问题排查

问题分析 #

你碰到的TS2792错误，核心是TypeScript的模块解析策略未正确配置，且缺少dotenv的类型定义文件。

解决方案 #

1. 安装dotenv的类型依赖 #

执行命令安装@types/dotenv：

npm install @types/dotenv --save-dev

2. 修改tsconfig.json配置 #

在tsconfig.json的compilerOptions中添加moduleResolution配置项，设置为node：

{
  "compilerOptions": {
    "target": "es2016",
    "module": "ES6",
    "moduleResolution": "node", // 新增该行
    "outDir": "compiled",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "noImplicitAny": true,
    "noImplicitThis": true,
    "alwaysStrict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitOverride": true,
    "skipLibCheck": true
  },
  "typeRoots": ["./node_modules/@types"],
  "include": ["src/**/*"],
  "exclude": ["node_modules", "compiled", "dist"]
}

原因说明 #

• 当TypeScript使用ES6模块系统时，默认模块解析策略并非Node.js规则，设置moduleResolution: node会让TypeScript按Node.js方式到node_modules目录查找第三方模块。
• @types/dotenv是dotenv包的TypeScript类型定义文件，缺少它TypeScript无法识别dotenv的模块结构，会抛出找不到模块的错误。

内容的提问来源于stack exchange，提问作者Leonardo Da Vinci