TypeScript+Node.js中如何配置绝对路径？运行报错求助

1. 先把tsconfig的路径配置搞对 #

首先得确保你的tsconfig.json里已经正确设置了baseUrl和paths——这是VSCode能识别但ts-node不行的核心原因：VSCode会读取tsconfig的路径映射，但ts-node默认不会处理这项配置：

{
  "compilerOptions": {
    "baseUrl": "./", // 如果所有源码都在src文件夹里，改成"src"更合理
    "paths": {
      "helpers": ["src/helpers/index.ts"], // 对应你helpers文件夹的实际路径
      "helpers/*": ["src/helpers/*"] // 要是helpers里还有子文件夹需要导入，就加上这个
    },
    // 下面这些是Node.js项目常用的基础配置，别漏了
    "module": "CommonJS",
    "target": "ES6",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "strict": true
  },
  "include": ["src/**/*"], // 确保所有源码文件都被TypeScript识别
  "exclude": ["node_modules"]
}

2. 给ts-node加上路径映射支持 #

ts-node默认不处理tsconfig里的paths，得装个辅助包或者改配置：

方法一：用tsconfig-paths包 #

• 先装依赖：

npm install -D tsconfig-paths

• 然后改package.json里的启动脚本，加个注册钩子：

{
  "scripts": {
    "start": "ts-node -r tsconfig-paths/register src/index.ts"
  }
}

-r tsconfig-paths/register的作用就是让ts-node启动时加载路径映射规则。

方法二：直接在tsconfig里配置ts-node #

不想每次启动都加参数的话，直接在tsconfig.json里加ts-node的配置：

{
  "ts-node": {
    "require": ["tsconfig-paths/register"]
  },
  "compilerOptions": {
    // 你的原有配置
  }
}

之后启动脚本直接用ts-node src/index.ts就行。

3. 同步ESLint的配置（如果用了ESLint） #

要是你项目里配了ESLint，得让它也能识别绝对路径，不然会报红：

• 先装解析器依赖：

npm install -D eslint-import-resolver-typescript

• 然后改.eslintrc.json：

{
  "settings": {
    "import/resolver": {
      "typescript": {
        "project": "./tsconfig.json"
      }
    }
  },
  // 其他ESLint规则
}

4. 核对项目结构 #

确保你的文件夹结构和路径配置对应上，比如：

你的项目根目录/
├── src/
│   ├── helpers/
│   │   ├── index.ts
│   │   ├── generateOTP.ts
│   │   └── sendOTP.ts
│   └── 你的入口文件（比如index.ts）
├── tsconfig.json
└── package.json

而且helpers/index.ts里要正确导出模块：

export { generateOTP } from './generateOTP';
export { sendOTP } from './sendOTP';

5. 测试启动 #

运行你的启动脚本（比如npm start），这会儿ts-node应该就能正确解析import { generateOTP, sendOTP } from 'helpers';了，不会再报找不到模块的错。

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