TS2307报错「Cannot find module」：文件复制后tsconfig路径别名导入失效

问题诱因 #

• 核心原因是tsconfig.json中的include配置范围过窄，当前配置仅包含./src/Server.ts单个文件，VSCode搭载的TypeScript语言服务仅会对纳入include范围、或被已纳入范围的文件主动引用的文件应用paths别名规则。你新建/复制的文件既不在include列表中，也没有被已生效的文件引用，因此无法识别别名路径。
• 项目编译能正常通过，大概率是你的构建工具（Webpack/Vite/Rollup等）自带的路径解析逻辑不受tsconfiginclude规则限制，或编译命令传入了额外的文件匹配规则。

解决方案 #

1. 修正include配置，覆盖所有需要用到别名规则的TypeScript文件，示例配置如下：

{
  "include": [
    // 匹配src目录下所有.ts文件
    "./src/**/*.ts",
    // 匹配别名指向的middleware目录下所有.ts文件
    "./middleware/src/**/*.ts"
  ]
}

如果需要支持tsx文件，额外添加./src/**/*.tsx规则即可。

2. 可选优化paths配置，支持别名下的子路径导入：
   你当前的paths配置仅支持导入@middleware根路径的默认导出，如果需要导入@middleware下的子目录/文件，修改为：

"paths": {
  "@middleware/*": ["./middleware/src/*"]
}

3. 配置修改后，按Ctrl+Shift+P（Mac为Cmd+Shift+P）唤起命令面板，执行TypeScript: 重启TS服务器，等待服务重启完成后即可生效。

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