TypeScript项目npm start报无法找到本地模块./route/routes错误

该错误是运行时模块解析失败，和TypeScript类型检查规则无关，核心触发点有两个：

• 当前npm run start使用的命令babel-node --presets es2015仅支持ES2015语法转译，既无法识别TypeScript语法，也不会按TS规则扫描.ts后缀的本地模块
• 没有配置TS对应的Babel转译规则，babel-node运行server.ts时，会按照纯JavaScript的查找逻辑定位./route/routes，仅优先匹配.js/.json/index.js类型文件，不会识别你编写的routes.ts文件
  原有JS项目能正常运行，是因为当时的本地模块都是.js后缀，匹配babel-node的默认查找规则，迁移为.ts后没有同步调整运行时配置，才触发了找不到模块的报错。

1. 替换兼容TS的Babel依赖 #

你当前使用的是Babel 6.x旧版本，和TS转译的生态不兼容，需要先卸载旧的babel相关依赖，再安装Babel 7的对应版本：

# 卸载旧依赖
npm uninstall babel babel-cli babel-preset-es2015 babel-preset-stage-0
# 安装新依赖
npm install --save-dev @babel/core @babel/cli @babel/preset-env @babel/preset-typescript

2. 编写Babel配置 #

在项目根目录新建.babelrc配置文件，写入如下内容：

{
  "presets": [
    ["@babel/preset-env", {
      "targets": {
        "node": "current"
      }
    }],
    "@babel/preset-typescript"
  ]
}

该配置会让babel-node直接识别TS语法，同时支持扫描解析项目内所有.ts后缀的本地模块。

3. 修正启动脚本 #

打开package.json，把原来的start脚本从：

"start": "NODE_ENV=production babel-node --presets es2015 server.ts"

修改为：

"start": "NODE_ENV=production babel-node server.ts"

去掉硬编码的旧预设参数，让babel-node读取根目录的.babelrc配置完成转译。
同时可以把dev脚本从node server.ts改为NODE_ENV=development babel-node server.ts，避免开发时也出现TS语法无法识别的问题。

4. 补充第三方库的类型声明 #

因为next-routes没有自带TypeScript类型定义，打开项目根目录的next-env.d.ts，追加一行声明：

declare module 'next-routes';

避免后续出现第三方库无类型定义的提示。

配置完成后执行npm run start，如果仍报找不到模块，依次核对：

• 检查server.ts内的import路径./route/routes和实际文件的相对路径完全匹配，注意大小写和forceConsistentCasingInFileNames的配置要求一致
• 确认tsconfig.json的include范围已经覆盖**/*.ts（你当前的配置已满足，无需修改）
• 确认.babelrc没有限制扫描的文件后缀范围

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